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ABSTRACT 


This document presents a system description of, and user's 
guide for, the Configuration Analysis Tool (CAT). As a con- 
figuration management tool, CAT enhances the control of 
large softv/are systems by providing a repository for infor- 
mation describing the current status of a project. CAT pro- 
vides an editing capability to update the information and a 
reporting capability to present the information. CAT is an 
interactive program available in versions for the PDP-11/70 
and VAX-11/780 computers. 
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SECTION 1 - INTRODUCTION 


The Configuration Analysis Tool (CAT) is an information 
storage and repc rt generation tool for support of configura- 
tion management activities. Configuration matiagement is a 
discipline composed of many techniques selected to track and 
direct the evolution of complex systems. Most configuration 
management activities can be categorized as follows: 

• Information gather ing--The current state of a sys- 
tem must be known in sufficient detail to support 
activities in the two categories specified below. 
The required information must be descriptive, cur- 
rent, and accurate. 

• Configuration analysis--The interrelationships 
among various system components must be described 
in a manner that permits the impact of configura- 
tion changes to be predicted for each system compo- 
nent. 

• Resource allocation--In response to the configura- 
tion analysis, priorities and schedules must be 
established that minimize the impact of system 
modifications and make effective use of all avail- 
able resources. 

CAT provides facilities to aid configuration management 
activities in the first two categories specified above. 

Section 2 contains a detailed system description of CAT. 
Section 3 provides a user's guide to the program. 

Appendixes A through E provide program subroutine descrip- 
tions; COMMON block information; file structure information; 
error messages; and system generation, overlay, and task 
building information, respectively. 


1-1 


9023 


SECTION 2 - CAT SYSTEM DESCRIPTION 


2. 1 INTRODUCTION 

CAT is an interactive program designed to accept, organize, 
and store information describing the status of a project. 

The information, which is concerned with the design, imple- 
mentation, testing, and maintenance of a project's software, 
is resident on a direct-access storage device. The informa- 
tion can be updated with the CAT editor subsystem or re- 
ported by the CAT report generator subsystem. 

CAT is available in versions to run on either a PDP-11/70 or 
on a VAX-11/780. There are no source code differences be- 
tween the PDP and VAX versions. The descriptions of CAT 
subroutines, COMMON blocks, and file structure, which appear 
in Appendixes A, B, and C, respectively, apply to both ver- 
sions of the program. The system generation procedures are 
different for each version (PDP and VAX) and are presented 
in Appendix E. 

The overnll flow of information to and from CAT is shown in 
Figure 2-1. The user controls all CAT processing via CRT 
input. Most processing instructions are communicated ^y 
selecting an option from a menu display presented at the 
terminal. CAT reads data from, and writes data to, the 
project file in response to the user's requests for proces- 
sing. When the user selects the printer as the output de-, 
vices for CAT reports, CAT writes the reports to a printer 
file (CATLST.LST) in the user's directory. This file may be 
spooled to the system printer via a system utility after the 
session with CAT is terminated. 

The following subsections describe the software that per- 
forms the CAT processing and the files used by CAT. 
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2.2 CAT PROCESSING 


As shown in Figure 2-2, CAT consists of an executive rou- 
tine, CAT, and two subsystems; the report generator and the 
editor. The following subsections discuss the processing 
performed by these three components of CAT. 

2.2.1 EXECUTIVE 

The CAT executive routine performs initialization and termi- 
nation chores, controls the user's selection of a project 
file, and presents the user with the choice of obtaining 
reports or editing the project file. The baseline diagram 
for the executive is shown in Figure 2-3. (The r xt level 
of called routines is ..>l)own in later figures.) 

The executive prompts the user for a project name. If the 
user enters a null line (carriage return only) , the execu- 
tive closes all files that are open and terminates the 
session. When a project name is entered, the executive pro- 
ceeds to prompt the user to select either the report genera- 
tor or the editor. If the report generator is selected, the 
executive attempts to open the indicated project file with a 
status of OLD. If the file does not exist, the user is 
prompted for another project name. When the editor is 
selected, the file is opened with a status of OLD if it 
exists. If the file does not exist, the executive verifies 
the project name with the user and opens the project file 
with a status of NEW. 

The executive passes control to routine EDTSEL if the editor 
is selected and to routine REPORT if the report generator is 
selected . 

2.2.2 EDITOR 

The CAT editor subsystem controls the user's selection of a 
subfile from the project file. After the user has selected 
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a subfile, further processing depends upon the current status 
of the subfile. (The ^aseline diagram for the entire editor 
subsystem is shown in Figure 2-4.) 

When the user selects a subfile that is cutrencly empty, the 
editor subsy:^tem passes control to routine CATPUT. CATPUT 
prompts the user for data to be storeu in each record to be 
entered into the initial version of the subfile. As long as 
the user enters a value for the first field in the record, 
CATPUT prompts for the succeeding fields. A recovd is 
detached from the list of available records (see 
Section 2.3.1), the user's data is copied into the record, 
and the record is linked to the end o*. the current subfile. 
When the user enters a null line in response to a prompt for 
the first data field in a record, CATPUT terminates con- 
struction of the subfile and returns control to the execu- 
tive routine for the editor subsystem (EDTSEL) . 

If the user selects- a subfile that contains data the editor 
subsystem passes control to routine EDITOR. EDITOR controls 
the disposition of the scratch files used during an edit 
session with CAT. The scratch files are opened with routine 
OPNX and the contents of the selected subfile are copied 
into the primai / edit file (see Section 2.3.2) by routine 
CATFIL. The edit command processing routine, EDIT, is given 
control until the user uses a "KILL" or "EXIT" command to 
terminate the edit session. The user's requested modifica- 
tions to the subfile are made using the scratch files. If 
the user terminates the edit session with a KILL command, 
all scratch files are deleted and control is returned to the 
EDTSEL routine. 

When the user terminates an edit session with the EXIT com- 
mand, routine REDCAT is used to recreate the edited subf-le 
using the data from the scratch files. Any data remaining 
in either the primary edit file or the backwards edit file 
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(see Section 2.J.2) has been placed in the forwards file at 
the end of the edit session. The forwards file is read from 
start to finish by REDCAT and each block of sequential re • 
ords cor responding to a subfile record is examined. When 
the block of records has been flagged for deletion, the 
corresponding record in the subfile is detached from the 
subfile (by adjusting the pointers on the previous and fol- 
lowing records in the subfile) and linked at the front of 
the list of available records. Ail other blocks of records 
are returned either to their originating subfile records or 
to the subfile records assigned and linked in the editor 
insert operation. 

Within the editor command processing routine, each user com- 
mand IS read and parsed by routine GETLIN. Once recognized, 
each command is executed by the appropriate editor routine 
(ADD, ADDP, BOT, CATINS, CHG, DEL LOC, NEX, NEXP, PRI, and 
TOP). Each editor routine uses the MOVE or MOVLIN utility 
routine to obtain the target record from the appropriate 
edit scratch file and to replace any modified record. 

2.2.3 REPORT GENERATOR 

The CAT report generator subsystem controls the user's se- 
lection of report type, report content, and output device. 
The baseline diagram for the entire report generator sub- 
system is shown in Figure 2-5. The report generator execu- 
tive routine, REPORT, obtains the user's choice of output 
device (uerminal or printer) and opens the printer file 
(CATLST.LST) if it has not been previously used. 

The report type selection routine, REPSEL, is called to ob- 
tain the user's choice of report type. If the subfile con- 
taining the user's requested data type exists, the appropri- 
ate report generation routine is called. The routines that 
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produce the Discrepancy and Change History report (CRTDIS 
and PRTDIS) use routine PIKONE to identify the subset of 
Discrepancy and Change History data selected by the user. 

2. 3 CAT FILE STRUCTURE AND USAGE 

All data required by CAT for a specified project reside in a 
single project file. The structure of this file is des- 
cribed in Section 2.3.1 below. When the CAT editor is used 
to modify an existing subfile in the project file, three 
edit scratch files are used while manipulating the data. 

The edit scratch files are described in Section 2.3.2. 

2.3.1 PROJECT FILE STRUCTURE 

CAT project files are direct access files with fixed-length 
(176 byte) records. Each project file may contain up to 
five types of records as described in Appendix C. 

Figure 2-6 shows how the records in a project file are or- 
ganized. 

A newly created project file contains a header record and a 
list of available records. The header record is record 
number one in the direct access file and contains pointers 
to all other linked lists of records in the file. In a new 
project file, all pointers, except the pointer to the list 
of available records, are initialized to zero since no sub- 
files exist. 

The list of available records is a singly linked list with 
forward pointers. A pointer (AVAIL) to the first record in 
this list (the "front" of the list) is kept in the header 
record. The last record in the list of available records 
contains a null forward pointer. The record at the front of 
the list is detached and added to a subfile whenever a new 
record is required. A record deleted from a subfile is re- 
turned to the front of the list of available records. Sub- 
routine GETMOR (see Appendix A) is used to extend the list 
of available records whenever it is emptied. 
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The three subfiles are made up of the records that contain 
data. Subfiles 1, 2 , and J contain Discrepancy and Chanoe 
History data. Mi lestone/ Del i verable History data, and Test 
History data, respectively. Each subfile if a doubly linked 
list. The header record contains a pair of pointers for 
each subfile. If the subfile contains one or more records, 
the pointers in the header record indicate the first and 
last records in the subfile. The Cirst record in a subfile 
contains a null backward pointer and the last record in a 
subfile contains a null forward pointer as shown in 
Figure 2-b. Records are added to or deleted from a subfile 
by adjustin'^ the pointers on the previous and following rec- 
ords. 

:.3.2 EDIT SCRATCH FILES 

The CAT editor subsystem creates a set of three scratch 
files for use in manipulating the data in an existing sub- 
file (see Section 2.2.2). The three files are the primary 
file, the forwards file, and the backwards file. Each file 
may contain records organized into record blocks. 

A record block consists of a "breakpoint record" followed by 
data records. The breakpoint record contains the record 
number of the project file record that originated the data 
contained in the data records. The number of data records 
in a record block depends upon the number of data fields in 
the subfile used to create the edit scratch files. A data 
record is written for each data field in a subfile record. 
The data record contains a descriptive label (from COMMON 
block CATCOM) followed by the contents of a data field ftom 
the subfile record. 

Every record in the edit scratch files contains a record 
type flag in the first five bytes of the record. Table 2-1 
shows the type flags and their meaning. 
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Table 2-1. Edit Scratch File Record Type Flags 


Flag Value 
’•)zJ)6)zi-2 '• 

")zJJ60Jz51'' 


Record Type 

End of file recoro 

Breakpoint record 

Beginning of file record 

Deleted record (all records in a block, 
including the breakpoint record) 

Data record 
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The three edit scratch files are direct access files and 
contain formatted records 88 bytes in length. The 
associated variable for each file is used to point to the 
next record to be read or written. 

The primary file is created at the start of an edit session 
once the subfile type to be edited is selected. Each record 
in the subfile is read and a breakpoint record and a group 
of data records are created and written to the primary 
file. A record with an end of file record type flag is 
written to the primary file after the last subfile record is 
processed. After the primary file is created, its associ- 
ated variable, LFILEO, is set to point to the first record 
in the file. From this point on, the records in the primary 
file are always read in sequential order. 

The forwards file and the backwards file are filled with 
records as the user manipulates what appears to be a single 
file. The user examines and changes this imaginary file by 
moving a "current line pointer." As the user moves the cur- 
rent line pointer down the edit file, records are moved from 
the primary file to the forwards file as the pointer passes 
them. If the user moves the current line pointer up in the 
edit file, records ate moved in reverse order from the for- 
wards file to the backwards file. If the user again changes 
direction and moves the current line pointer down the file, 
records are moved from the backwards file in reverse order 
to the forwards file until the backwards file is emptied at 
which point records are again moved from the primary file to 
the forwards file. 

The associated variables for the primary, forwards, and 
backwards files (LFILEO, LFORWO, and LBKWO, respectively) 
always point to the next sequential record in each file. 
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The "current line” pointed to by the current line pointer is 
the last valid record in the forwards file (record number 
LFORWO - 1) . This record is modified by the change and add 
commands. Record blocks inserted by the user are added to 
the end of the forwards file. Records in record blocks that 
have been deleted are marked with the delete record type 
flag (Table 2-1) and become unavailable to the user although 
they continue to be moved between the forwards and backwards 
file. 

Figures 2-7 and 2-8 illustrate a simple example in which the 
user edits a subfile containing five records. Figure 2-7 
shows the primary file containing the original five record 
blocks and the forwards file containing a new record block 
inserted by the user following the first block. The current 
line in this figure is the last record in the original sec- 
ond block. Figure 2-8 shows the contents of these files if 
the user positions the current line pointer to the last rec- 
ord in the first record block. Note that the records form- 
ing the inserted block and the original second block have 
been moved to the backwards file and are in reverse order. 

If the user ends a session with the EXIT command, the cur- 
rent line pointer is moved automatically to the end of the 
file; that is, any records in the backwards file are moved 
to the forwards file and then any records remaining in he 
primary file are moved to the forwards file. The records in 
the forwards file are then used to reconstruct the subfile. 
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PRIMARY 

FILE 


FORWARDS 

FILE 


BACKWARDS 

FILE 



LBKWO 


Figure 2-7. Edit Scratch Files After Inserting a New 
Block of Records Following the First 
Block and Then Positioning the File 
Following the Original Second Block 
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SECTION 3 - CAT USER’S GUIDE 


3.1 INTRODUCTION 

CAT is an interactive software management reporting program 
implemented on the PDP-11/70 computer under the RSX-llM 
operating system and on the VAX-11/780 computer under the 
VMS operating system. The minimum operating configuration 
is a terminal and a lineprinter. The terminal acts as both 
the input and the output device when the user is interacting 
with the program. The processed output is in the form of 
project reports, which may be directed to either the user 
terminal or a disk file for listing on the line printer. 

CAT stores information in a separate file for each project. 
Each file contains three subfiles. These subfiles contain 
the data for the reports generated by CAT (see Tables 3-1 
and 3-2) . 

The following sections provide input formats and user in- 
structions for running CAT. Sections 3.2, 3.3, and 3.4 
specify the procedures for program initialization, use of 
the CAT editor, and use of the CAT report generator, respec- 
tively. Section 3.5 provides a summary of CAT user informa- 
tion. 

CAT informs the user of abnormal conditions during execution 
by writing messages to the user's terminal. Appendix D 
lists each message and an explanation of the probable cause 
of the message. 


! 
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Table 3-1. CAT Report Purpose 


Report Name Content Description 

Discrepancy and Change Describes errors (discrepancies) and 
History changes for a project 

Milestone/Deliverable Describes milestone event and 

’■istory deliverable schedules 

Test History Describes tests and test results 
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Table 3-2. CAT Report Data Descri 


Discrepancy and 
Change History 

Date discrepancy or 
change defined 

Date discrepancy or 
change corrected 

Actual date 
released 

Programmer assigned 

Code denoting dis- 
crepancy (D) or 
change (C) 

Description of 
discrepancy of 
change 

Changes ma^i » to the 
system for 
cor rection 


Milestone/Deliverable 
History 

Date Milestone/ 
Deliverable defined 

Release scheduled date 

Actual date released 

Programmer assigned 
Type of deliverable 

Milestone event de- 
scr iption 
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Test History 
Date tested 

Programmer 

assigned 

Description of 
test performed 

Test results 
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' • ‘ CAT INITIALIZATION 

After loqqing on to the PDP-11, 70 computer, the user initi- 
al tes a CAT session with the following command; 

DBl ; I 2 I J , 2 1 CAT 

On the VAX-1 L 780, CAT is started with the following command 
3 RUN DBBl: [TOOLS 1 CAT 

There are no prerun allocations to bo made since CAT per- 
forms these internally as needed. The first prompt issued 
by CAT requests a project name: 

LNTER PROJECT NAME> 

I’he project name is a unique character strinq (of up to six 
characters) that identifies the particular CAT project 
t ile. Eollowinq the entry of a project name, o'Ar displays 
the followinq menu (OPTION MENU): 

OPTION MENU 
1 EDITOR 
: REPORTS 

CAT' 

Menus are used throuqhout CAT to provide a quick and easy 
way for the user to indicate decisions. Each item on a 
q iveri menu is preceded by an integer number; to select one 
of these items, the user types in the appropriate integer 
and presses the carriage return. If the user enters a null 
line (carriage return only), CAT displays the menu that pre- 
ceded the current menu. 

Entering anything other than a displayed selection number or 
a null line (carriage return only) results in the following 
message ; 

**** IS AN INVALID OPTION 
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where the number at the start of the message is the user's 
invalid input. 

If the user enters a carriage return in response to the 
ENTER PROJECT NAME prompt, CAT terminates with the following 
message : 

**********^;;^.r terminated********** 

and the user is returned to the operating system control. 

The correct way to terminate CAT is to return to this prompt 
and press the carriage return, thus allowing CAT to "clean 
up" correctly. Terminating in any other way (e.g., CTRL/C) 
produces unpredictable results. 

Menus in CAT are arranged in a hierarchy, or tree. The 
OPTION MENU is at the top of the tree. In this and the fol- 
lowing sections, the level of the menu in the hierarchy is 
indicated by a circled number to the right of each sample 
shown . 

The following instructions pertain to the OPTION MENU, which 
is repeated below. 

OPTION MENU ® 

1 EDITOR 
: REPORTS 

CAT^ 

To edit the project data base, the user enters a 1. 

Section 3.J provides a guide for use of the CAT editor. To 
obtain history reports from the project data base, tie user 
enters a 2 . Section 3.4 provides a guide for use of the CAT 
report generator. 
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3.3 USE OF CAT EDITOR 


The CAT editor is invoked with the following response to the 
OPTION MENU: 

OPTION MENU ® 

1 EDITOR 

2 REPORTS 
CAT>1 

If the user has entered a new project name (pname ) , CAT will 
respond with 

NO SUCH FILE 

PROGRAM CREATING A NEW FILE FOR -- pname.DAT 
TO CONTINUE, ENTER Y FOR YES OR N FOR NO> 

If the answer to this prompt is N (no) , CAT prompts again 
with 

ENTER PROJECT NAME> 

If the answer is Y (yes ) , CAT creates the new project file. 

Following the entry of an existing project name or the crea- 
tion of the new project file, CAT displays the following 
menu: 

EDITOR - SELECT A DATA TYPE © 

1 DISCREPANCY & CHANGE DATA 

2 MILESTONE/DELIVERABLE DATA 

3 TEST HISTORY 
CAT> 

A carriage return returns the OPTION MENU to the screen. 
Typing a 1 through 3 requests an edit session for the corre- 
sponding data type su >file. Table 3-2 specifies the content 
of each of the three -ipes of subfiles. 
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If the user is editing a particular data type subfile for 
the first time for the selected project, CAT will respond 

*** CREATING NEW DATA FOR TYPE n 

where n is the integer value given to the EDITOR - SELECT A 
DATA TYPE menu. CAT then will display each field name on 
the terminal followed by a caret (>) . The caret is pre- 
ceded by a number in parentheses informing the user of the 
length of the data field requested by the prompt. After the 
user enters the data (or enters s carriage return only), CAT 
prompts for the next field of data. 

To exit from the subfile creation mode, the user should re- 
spond with a carriage return only to the prompt for DATE 
DEFINED (Discrepancy and Change subfile or Milestone/ 
Deliverable subfile) or for TEST DATE (Test History sub- 
file). These fields are the first in a sequence of fields 
(listed in Table 3-2) which make up a "block” of data. 

After exiting the editor, CAT will redisplay the previous 
menu, EDITOR - SELECT A DATA TYPE. 

If the user edits a subfile that already exists, CAT prompts 
the user with 

CAT>* 

The user responds with any of the commands described in 
Table 3-3. These commands are a subset of the tuit commands 
used by the DEC Line Text Editor (EDI) . The syntax and the 
resulting action for these commands are exactly as described 
in the EDI manual (Reference 1) with the following except- 
ions for the insert, delete, locate, and change commands. 

The insert (I) and delete (D) commands act upon a block of 
lines rather than on single lines as in the EDI editor. 

If an insert command is entered, the editor locates the last 
line of the block to which the current line belongs and 
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Table 3-3. CAT Editor Functions 


Function 

Conunand Format 

Description 

ADD 

A 

Adds text following add com- 
mand to end of current line 

ADO AND 
PRINT 

AP 

Adds text following add com- 
mand to end of current line; 
prints out current new line 

INSERT 

I 

Issues prompts for data for 
new record "block” 

NEXT 

N(n) 

Establishes a new current 
line plus or minus n lines 
from current I.ine 

NEXT AND 
PRINT 

NP(n) 

Establishes a new current line 
plus or minus n lines from 
current line; prints new cur- 
rent line 

CHANGE 

C/STRING1/STRING2 

Searches for STRINGl to the 
right of the '>' and re- 
places it with text specified 
in STRING2 

BOTTOM 

BO 

Sets current line pointer to 
bottom of file 

TOP 

TOP 

Sets current line pointer to 
top of file 

DELETE 

D(n) 

Deletes current and next n-1 
record "blocks" if n is posi- 
tive; deletes n preceding 
record "blocks" (but not cur- 
rent record "block") if n is 
negative 

EXIT 

EX 

Exits from CAT edicor and 
saves data in master file 

KILL 

KILL 

Exits from CAT editor (proj- 
ect file contents are not 
changed) 

LOCATE 

L STRINGl 

Locates and displays first 
occurrence of STRINGl 

PRINT 

P(n) 

Prints next n lines at the 
terminal 
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begins to prompt the user for data fields. Each line is 
inserted into the subfile at that location. To terminate 
the insertion, the user responds with a null line (carriage 
return only) to the prompt for DATE DEFINED or TEST DATE. 

If a delete command is entered, the editor deletes all lines 
of the block which contains the current line. If a multiple 
deletion is specified (Dn) , the editor deletes the current 
block and the n-1 following blocks. 

The locate (L) and change (C) commands act almost the same 
as in the EDI editor. The locate command may be used to 
search for any string displayed to the user, including the 
prompt text at the start of each line. The change command, 
however, will affect only text which appears to the right of 
(and not including’, the caret. 

The EX or KILL command will result in termination of the 
edit session and the redisplay of the EDITOR - SELECT A DATA 
TYPE menu. 
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3.4 USE OF CAT REPORT GENERATOR 


The Cat report generator is invoked by the following re- 
sponse to the OPTION MENU: 


OPTION MENU 

1 EDITOR 

2 REPORTS 
CAT >2 



CAT then requests a selection of the output device for the 
generated reports: 


OUTPUT LISTING DEVICE SELECTOR 

1 CRT 

2 PRINTER 
CAT> 



A carriage return requests a return to the OPTION MENU. 
Entering a 1 selects the user terminal as the report output 
device. If the user enters a 2 in response to the OUTPUT 
LISTING DEVICE SELECTOR menu, CAT will write the reports ti 
the disk file "CATLST. LST" . On termination of the CAT ses- 
sion, this data file may be spooled to the lineprinter by 
the user via one of the system utilities. 

If the user enters a 1 or a 2, CAT requests the selection of 
a particular report: 

REPORT - SELECT DATA TYPE ® 

1 DISCREPANCY AND CHANGE HISTORY DATA 

2 MILESTONE/DELIVERABLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 
CAT> 


A carriage return returns the OUTPUT LISTING DEVICE SELECTOR 
menu to the screen. Entering a 1 through 3 requests the 
corresponding report. Entering a 4 will display all of the 
reports . 
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Tables 3-1 and 3-2 specify the purpose and content of each 
of the three reports. 

If the user terminal is the current output device selected, 
CAT will display a header line with column labels and 
14 lines of data per screen followed by a CAT> prompt. A 
carriage return in response to the CAT> prompt will dis- 
play the next screen or redisplay the REPORT menu if there 
are no more data. The user can terminate a report prema- 
turely by responding to the CAT> prompt with a "?" rather 
than a carriage return. This response will redisplay the 
REPORT - SELECT DATA TYPE menu. 

If the lineprinter is the current output device, CAT will 
display on the user terminal the name of the report selected 
while the CAT program is writing the report to the 
'•CATLST.LST" file. 

If the user selects item 1 or 4 from the REPORT - SELECT 
DATA TYPE menu: 

REPORT - SELECT DATA TYPE ® 

1 DISCREPANCY AND CHANGE HISTORY DATA 

2 MILESTONE/DELIVERABLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 
CAT> 

before the DISCREPANCY AND CHANGE HISTORY DATA report is 
displayed or written to the print file, the DISCREPANCY - 
CHANGE SELECTOR menu will be presented: 

DISCREPANCY - CHANGE SELECTOR ® 

1 CHANGE 

2 DISCREPANCY 

3 UNFINISHED 

4 ALL 
CAT> 
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If the user responds with a 1» only the data marked with a 
*'C" will be displayed. A response of 2 displays data marked 
with a "D" only. Selecting item 3 displays only the data 
(CHANGE and DISCREPANCY) that has a blank DATE CORRECTED 
field associated with. A response of 4 displays all of the 
data in the Discrepancy and Change subfile. After the se- 
lected reports have been displayed or written to the print 
file, the REPORT - SELECT DATA TYPE menu is redisplayed. 

As noted before, a carriage return can be used to return the 
previous menu to the screen. Thus, the user may proceed up 
and down the menu hierarchy, generating reports on different 
devices as desired. 
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3 . 5 SUMMARY 


This section provides a summary of CAT user information. 
Sections 3.2, 3.3, and 3.4 should be read for a more de- 
tailed discussion of program use. 

The essential steps in the use of CAT are as follows: 

1. The user initiates a CAT session with the command 

>RUN DBl; [213,2]CAT (PDP-11/70) 

$RUN DBBl: [TOOLS] CAT (VAX-11/780) 

2. CAT prompts with 

ENTER THE PROJECT NAME > 

If the requested project file exists, the user 
immediately enters the program. If the requested 
project file does not exist, CAT asxs if the user 
desires to create a new project file. 

3. After the user has successfully entered the pro- 
gram, CAT displays a series of menus (see 
Figure 3-1) . The hierarchy of menus allows the 
user to edit the project files or to generate re- 
ports. 

Each item in a menu is preceded by an integer by 
which the user selects an item. The user selects 
the item and then presses the carriage return. If 
the user presses the carriage return without se- 
lecting an item, CAT returns the previous menu to 
the screen. 

4. In the edit mode, CAT prompts the user for one of 
the edit commands in Table 3-3 with 

CAT>* 
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Fiaure 3-L. CAT Menu and Prompt Hierarchy 
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The user types the desired command and then presses 
the carriage return. 

5. In the report mode# CAT prompts the user for an 
output device. If the device selected is the 
printer, CAT generates a new data file, CATLST.LST, 
which the user can print after the CAT session. 

6. While the output device is the CRT, CAT will dis- 
play the requested report at the user's terminal. 

7. When the Discrepancy/Change report is requested, 

CAT will display the DISCREPANCY-CHANGE SELECTOR 
menu. Selecting CHANGE results in a report of only 
those items flagged as changes. Selecting 
DISCREPANCY results in a report of only those re- 
ports marked as discrepancies. Selecting 
UNFINISHED will display all items that have not 
been completed. 

8. To exit CAT properly, the user returns to the ENTER 
PROJECT NAME prompt with a series of ca..riage re- 
turns and enters a carriage return to terminate the 
session. CAT then displays the following message: 

******** CAT TERMINATED ******** 

Figures 3-2 though 3-19 show a session with CAT. The ses- 
sion is described below. 

Figure 3-2 shows the start of a session in which the user 
requests the creation of a new CAT data base file, 
GESTIT.DAT. 

Note that the user only specifies the file name, GESTIT, and 
does not specify the extension .DAT. 

Figure 3-3 shows the editor session in which a new Discrep- 
ancy and Change (D/C) subfile is created. Four 
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RUN CAT 

ENTER PROJECT NAME>GCSTIT 


OPTION MENU 

1 EDITOR 

2 REPORTS 
CAT>1 

NO SUCH FILE 

PROGRAM CREATING A NEW FILE FOR -- GESTIT.DAT 
TO CONTINUE* ENTER Y FOR YES OR N FOR NO>Y 


Figure 3-2. StartinQ CAT and Creating a New Data Base File 
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EDITOK - SELECT A DATA TYPE 

1 DISCREPANCY I CHANGE DATA 

2 MILLSTONE/DELIVERABLE DATA 

3 TEST HISTORY 
CAT>1 

**♦ CREATING NEW DATA FOR TYPE 1 


DATE DEFINED (MM/'JD/YY) ( 8> >09/01/32 
DATE CORRECTED (M/DD/YY) ( S) 09/15/82 
DATE RELEASED <MM/DD/YY) ( 8) > 

IMPLEMENTOR ( 8) ,; W. TAYLOR 
CODE <C OR D) < 1) >C 

DESC (60) >ENHANCE THE CAT PROGRAM TO BE MORE EFFIEICNT 
CHANGES (22) ^MODIFIED MANY ROUTINES 
DATE DtFINED (MM/DD/YY) ( 8) >09/02/82 
DATE CORRECTED (MM/DD/YY) ( 8) ' 

DATE RELEASED (MM/DD/YY) ( 3) > 

IMPLEMENTOR ( 3) U.TALOR 
CODE (C OR D) ( 1) >D 

DESC (60) >DESCREPANCY WITHIN THE REDCAT ROUTINE 
CHANGES (22) >POI‘'»TERS INCORRECT FOR DATA FILES 
DATE DEFINED (MM/DD/YY) ( 3) >09/03/32 
DATE CORRECTED (MM/DD/YY) ( 3) >09/21/82 
DATE RELEASED (MM/DD/YY) ( 8) > 

IMPLEMENTOR ( 8) >U. TAYLOR 
CODE (C OR D) ( 1) >C 

DESC (60) >RECONSTRUCTED THE CAT PROAAM 
CHANGES (22) > 

DATE DEFINED (MM/DD/YY) ( 3) >09/02/32 
DATE CORRECTED (MM/DD/YY) ( 8) >09/21/82 
DATE RELEASED (MM/DD/YY) ( 8) > 

IMPLEMENTOR ( 8) >W« TAYLOR 
CODE (C OR D) ( 1) >D 

DESC (60) ; DELETEION OF THE IMPLICIT STATE.fENTS 
CHANGES (22) > 

DATE DEFINED (MM/DD/YY) ( 8) > 


Figure 3-3. Creating a New Discrepancy and Change Subfile 
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EDITOR - SELECT A DATA TYPE 

1 DISCREFAMCY t CHANGE DATA 

2 HILESTONE/DELIVERABLE DATA 

3 TEST HISTORr 
CAT>1 

CAT>*P20 

DATE DTPINED (MM/DD/YY) < 8) ;.09/01/82 
DATE CORRECTED (Mrt/DD/YY) < 8) >09/15/82 
DATE RELEASED (MM/DD/YY) ( 3) > 

IMPLEMENTOR ( 8) : W. TAYLOR 
CODE (C OR D) ( 1) >C 

DESC (60) >ENHANCE THE CAT PROGRAM TO BE MORE EFFIEICNT 
CHANGES (22) MODIFIED MANY ROUTINE^ 

DATE DEFINED (MM/DD/YY) ( 8) >09/02/82 
DATE CORRECTED (MM/DD/YY) ( 8) > 

DATE RELEASED (MM/DD/YY) ( 8) > 

IMPLEMENTOR ( 3) >U.TALOR 
CODE (C OR D) ( 1) >D 

DESC (60) >DESCREPANCY WITHIN THE REDCAT ROUTINE 
CHANGES (22) >P0 INTERS INCORRECT FOR 
DATE DEFINED (MM/DD/YY) ( 8) >09/03/32 
DATE CORRECTED (MM/DD/YY) ( 8) >09/21/82 
DATE RELEASED (MM/DD/YY) ( 8) > 

IMPLEMENTOR ( 8) >W« TAYLOR 
CODE (C OR D) ( 1) >C 
CAT>»NP-8 

IMPLEMENTOR ( 3) >W.TALOR 
CAT>*C/AL/AYL 

IMPLEMENTOR ( 8) >W. TAYLOR 
CAT>*NP-5 

DESC (60) >ENHANCE THE CAT PROGRAM TO BE MORE EFFIEICNT 
CAT>»C/I£IC/ICIE 

DESC (60) >ENHANCE THE CAT PROGRAM TO BE MORE EFFICIENT 
CAT>*C/DES/DESS 
NO MATCH IN LINE 
CAT>*L AA 

DESC (60) /RECONSTRUCTED THE CAT PROAAM 
CAT>!KC/AA/GRA 

DESC (60) >RECONSTRUCTED THE CAT PROGRAM 
LAT>*EX 


Figure 3-4. Returning To Edit the Discrepancy and Change 
Subfile 
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EDITOR - SELECT A DATA TYRE 

1 L SCREPANCY I CHANGE DATA 

2 MILESTONE/ DELIVERABLE DATA 

3 TEST HISTORY 
CAT 2 

*** CREATING NEW DATA FOR TYPE 2 


DATE DEFINED (rtfl/DD/YY) 9> >09/01/02 
DATE SCHEDULED (MM/DD/YY) >( 8) 09/30/32 

DATE ACTUAL (MM/DD/YY) > ( 8) >09/30/82 
IMPLEMENTOR ( 8) >U. TAYLOR 
TYPE ( 8) .'.FINAL 

MILE (72) :>DELH'ER THE NEU CAT PROGRAM 
DATE DEFINED (MM/DD/YY) ( 8) >09/02/02 
DATE SCHEDULED (MM/DD/YY) ( 8) 09/30/82 

DATE ACTUAL (MM/DD/YY) X 8) >09/30/82 
IMPLEMENTOR ( 3) >U. TAYLOR 
TYPE ( 8) .DRAFT 

MILE (72) >UPDATE USERS GUIDE FOR THE CAT PROGRAM 
DATE DEFINED (MM/DD/YY) > ( 3) 


EDITOR - SELECT A DATA TYPE 

1 DISCREPANCY S CHANGE DATA 

2 MILESTONE/DELIVERABLE DATA 

3 TEST HISTORY 
CAT>3 

*»* CREATING NEW DATA FOR TYPE 3 


TEST DATE (MM/DD/YY) ( 8) >09/01/82 

TEST CONDUCTOR ( 9) >U, TAYLOR 

DESC (72) >TEST OUT THE LATESS CAT PROGRAM 

RESULTS (32) SEEMS TO BE WORKING 

TEST DATE (MM/DD/YY) i 3) >0'?/02/C2 

TEST CONDUCTOR ( 3> “W.TAfLbR 

DESC (72) .'REMOVED ALL IMPLICIT STATEMENTS 

RESULTS (32) CORRECTED LOGIC ERROR 

TEST DATE (MM/DD/YY) ( 8) > 


Pi-uiro 3-3. 


Croatino Now '1 1 Lc?sti''nL' De I ivorab'ie and 
Tost UlstoiA' Subr'ilos 
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EDITOR - SELECT A DATA TYPE 

1 DISCREPANCY I CHANGE DATA 

2 HILESTUNE/DELU'ERADLE DATA 

3 TEST HISTORY 
CAT> 


OPTION MENU 

1 EDITOR 

2 REPORTS 
CAT>2 


OUTPUT LISTING DEVICE SELECTOR 

1 CRT 

2 PRINTER 
CATM 


Fiouro ?-b. 


Frocoedin'.i tuo Editin' to tho Report 

donerator [\ oi 2 ) 
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REPORT - SELECT DATA TYPE 

1 DISCREPANCY AND CHANGE HISTORY DATA 

2 MILESTONE/DEI. IGERADLE HISTORY DA1A 

3 TEST HISTORY DATA 

4 ALL 

CAT>1 


DISCREPANCY - CHANGE SELECTOR 

1 CHANGE 

2 DISCREPANCY 

3 UNFINISHED 

4 ALL 
CAT>4 
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When 'ALL' Items are Selected 
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F i v -1 u r e 


REPORT - SELECT DATA TYPE 

1 DISCREPANCY AND CHANGE HISTCFY DATA 

2 MILESTfJNE/DELIVERABLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 

CAT>2 


REPORT - SELECT DATA TYPE 

1 DISCREPANCY AND CHANGE HISTORY DATA 

2 MILESTONE/DELIVERADLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 

CAT>3 


3-li. Selecting the Milestone Deliverable and 
Test History Reports 
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REPORT - SELECT DATA TYPE 

1 DISCREPAMCY AND CHANGE HISTCRY DATA 

2 MILESTONE/DELI'JEFv'APLE -iiSTORY DATA 

3 TEST HISTORY DATA 

4 ALL 

CAT> 


OUTPUT LISTING DEVICE SELECTOR 

1 CRT 

2 PRINTER 
CAT ■ 2 


.ure 3-14. Charii.7ina the Report Output Device to the 
Linepr inter 
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REPORT - SELECT DATA TYPE 

1 DISCREPANCY AND CHANGE HISTORY DATA 

2 MILESTONE/DELU'PRADLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 

cat: 4 


tfISCREPANCY AND CHANGE REPORT SELECTED 


DISCREPANCY - CHANGE SELECTOR 

1 CHANGE 

2 DISCREPANCY 
5 UNFlNiSMtli 

4 ALL 
CAT. 4 


MILESTONE/DELIVERABLE REPORT SELECTED 
TEST REPORT SELECTED 


Figure 3-15. Requesting All Reports I'^hile the Output 
Device Is the Lineprinter 
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ORIGINAL PAGE IS 
OF POOR QUALITY 


KEPORT - SELECT DATA TYPE 

1 DISCREPANCY AND CHANGE HIGTORY DATA 

2 MILESTONE/DELIVERABLE HISTORY DATA 

3 TEST HISTORY DATA 

4 ALL 

CAT> 


OUTPUT LISTING DEVICE SELECTOR 

1 CRT 

2 PRINTER 
CAT> 


OPTION MENU 

1 EDITOR 

2 REPORTS 
cat;: 

LNTEK PRO lECT NAME. 

CAT TEFv'MINATING 


laure 5-IA. Terninatino CAT Prom the Report Generator 
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"blocks" of data are entered. Each block starts with the 
entry of a date for the DATE DEFINED field. Not all fields 
must be entered; however, if no date is entered into the 
DATE DEFINED field, data entry is tern nated and the 
KUITOR-SELECT A DATA TYPE menu is displayed (Fi^jure 3-4) . 

The number in parentheses immediately preceding the ' at 
the end of each prompt is the allowed length in characters 
for the data field to be entered. 

Figure 3-4 continues the session by showing how the user 
returns to the D/ C subfile to correct the errors made while 
creating the subfile. (The sixth editor command fails be- 
cause the string DES appears to the left of the '>' 
only.) The EX command is used to terminate an editor ses- 
sion with an old subfile. 

Figure 3-5 demonstrates the creation of the Milestone and 
Deliverable (M/D) and the Test History (TH) subfiles shown 
later in the session. The sessions are terminated by enter- 
ing a carriage return only for the DATE DEFINED (M/ D sub- 
file) and TEST DATE (TH Subfile) fields. 

In this session, the user moves from the editor to the re- 
pi>rt generator as shown in Figure 3-6. The user selects the 
terminal as the output device and requests that the DC re- 
port be generated for all data in the D/ C subfile. 

Figure 3-7 is the resulting report. Figures 3-8 through 
)-10 show the D/ C reports when the CHANGE, DISCREPANCY, and 
UNFINISHED options are selected. 

Figure 3-11 shows the user selecting the M/ D and TH reports 
shown in Figures 3-12 and 3-13. 

The user can change the report output device to the printer 
as shown in Figure 3-14 by entering a carriage return in 
response to the REPORT-SELECT DATA TYPE menu and reselecting 
an item from the OUTPUT LISTING DEVICE SELECTOR menu. 

- 3 5 


90 2 3 



Figure 3-15 continues the session by showing the result of 
selecting all reports (and a D/C report of all data) while 
the output device is the line printer. Note that the name 
of the report is displayed to the user while the report is 
being written to the printer file. Figures 3-16 through 
3-18 shown the printer format of all the reports. 

Figure 3-19 demonstrates how multiple carriage returns will 
terminate CAT. 
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APPENDIX A - CAT SUBROUTINE DESCRIPTIONS 


This appendix presents descriptions of each CAT subroutine. 
The descriptions provided here appear in alphabetical order 
by subroutine name. In addition to the routines listed in 
this appendix, CAT subroutines call the system routines as 
shown below. 

System Routine Called By 


DATE 

CRTDIS, 

CRTMIL 


CRTTST. 

PRTDIS 


PRTMIL, 

PRTTST 

ERRSET 

CAT 


ERRSNS 

CAT 


EXIT 

CAT 



These system routines are documented in References 2 and 3. 


A-i 


9023 


ROUTINE; ADD 


TYPE; Subroutine 

PURPOSE; Editor routine - add a c 
of the current line in the edit £i 

USAGE ; 

1. Calling Sequence; 

CALL ADD (STRINGl) 

FORTRAN Dimen- 

Name I/O Type sion 

STRNGl I Byte 80 

2. COMMON Blocks Used LUNCOM 

3. Subroutines Used; MOVE 

4. Subroutines Called by; EDIT 

5. External Data Sets Referenced; 

Lun File Name 

LFORW FOR007.DAT 

LOUT Terminal 


9023 


string to the end 


Description 


Character string to add 
to current line 


>eration (s) 


Write 

Write 


ROUTINE: ADDP 


TYPE: Subroutine 

PURPOSE: Editor routine - add a 

of the current line in the edit f 
line at the terminal. 

USAGE : 

1. Calling Sequence: 

CALL ADDP(STRNGl) 

FORTRAN Dimen- 

Name I/O Type sion 

STRNGl I Byte 80 

2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: MOVE, WKT 

4. Subroutines Called by: EDIT 

5. External Data Sets Referenced 

Lun File Name 

LFORW FOR007.DAT 

LOUT Terminal 


9023 



ROUTINE: BOT 


TYPE: Subroutine 

PURPOSE: Editor routine - selects the last line in the edit 

file as the current line. 

USAGE: 

1. Calling Sequence: 

CALL BOT 

2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: MOVE 

4. Subroutines Called by: EDIT 

5. External Data Sets Referenced: 

L un File Name Operation (s) 


LOUT 


Terminal 


Write 


ROUTINE; CAT 


TYPE; Main program 

PURPOSE; Executive routine - performs initialization and 
cleanup functions for program execution. Responds to user's 
selection of report generation or editor functions. Opens 
and closes the user's selection for a project file. 

USAGE; 


1. Calling Sequence; 

VAX; RUN DBBl; [TOOLS] CAT 
POP; RUN DBl; [213,2]CAT 

2. COMMON Blocks Used; FILCM 


3. Subroutines Used; EDTSEL, ERRSET, ERRSNS, EXIT, REPORT 


4. Subroutines Called by; None 


5. External Data 
Lun 


FILEl 

LUNA 

LUNOUT 


Sets Referenced; 
File Name 


User specified 

Terminal 

CATLST.LST 


Operation (s) 

Open, read, close 
Read, write 
Close 
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ROUTINE: CATFIL 


TYPE: Subroutine 

PURPOSE: Editor routine * creates a sequential file from a 

specified subfile. Each record in the subfile is used to 
create a block of records in the primary file^ each contain- 
ing a descriptive label and a data field from the subfile 
record. 

USAGE : 

1. Calling Sequence: 

CALL CATFIL (ITYPE) 

FORTRAN Dimen- 

Name I/O Type sion Description 

ITYPE I 1*2 1 Pointer to the specific 

subfile from which to 
create the primary file 

2. COMMON Blocks Used: CATCOM, LUNCOM, FILCM 

3. Subroutines Used: None 

4. Subroutines Called by: EDITOR 

5. External Data Sets Referenced: 


File Name 


FILEl User specified Read 

LFILE FOR002.DAT Write 

LUN5 Terminal Write 
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ROUTINE: GATINS 


TYPE; Subroutine 

PURPOSE: Editor routine - insert a block of records into 

the edit file. Locates the next available insertion point 
in the edit file and prompts the user for data to include in 
the file. Reserve" space for the data in the project file. 

USAGE: 

1. Calling Sequence: 

CALL CATINS (ITYPE, NEXT) 


FORTRAN 
Name I/O 

D imen- 

Tvpe sion 

Desc r ipt ion 

ITYPE I 

1*2 1 

Pointer to the specific 
subfile in the project 
file which is contained 
in the edit file 

NEXT I/O 

1*2 1 

Pointer to the next 
available record in the 
project file 

2. COMMON Blocks 

Used: CATCOM, 

FILCM, LUNCOM 

3. Subroutines Used: GETMOR, MOVLIN 

4. Subroutines Called by: EDIT 

5. External Data 

Sets Referenced 

• 

• 

Lun 

File Name 

Operation (s) 

FI LEI 

User Specified 

Read 

LUN 5 

Terminal 

Read, write 

LOUT 

Terminal 

Write 

LFORW 

FOR007.DAT 

Write 
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ROUTINE; CATPUT 


TYPE: Subroutine 

PURPOSE: Editor routine > accepts the initial data for a 

subfile containing no data. Data is read in response to 
prompts for each data field. After each block of data is 
read, a record is added to the subfile in the project file. 

USAGE: 

1. Calling Sequence: 

CALL CATPUT (ITYPE, STAT) 

FORTRAN Dimen- 

Name I/O Type sion Description 

ITYPE I 1*2 1 Pointer to the specific 

subfile in the project 
file which is being 
created 

STAT I L*1 1 Flag indicating presence 

of header record in 
project file: 

« 'O', old file, header 
present 

» • N' , new file, no 
header record 

2. COMMON Blocks Used; CATCOM, FILCM 

3. Subroutines Used: GETMOR 

4. Subroutines Called by: EDTSEL 

5. External Data Sets Referenced: 

Lun File Name 

FILEl User Specified 

LUN5 Terminal 

LUN6 Terminal 
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ROUTINE; 


-.iG 

TYPE; Subrc'»-ine 

PURPOSE: Editor routine - change a 

string in the current line in the e 
ter string. 

USAGE : 

1. Calling Sequence: 

CALL CHG (NUM, STRNGl) 


FORTRAN 



Dimen- 

Name 

I/O 

Type 

sion 

NUM 

I 

1*2 

1 

STRNGl 

I 

Byte 

80 


2. COMMON Blocks U:;ei: LUNCOM 

3. Subroutines Used: COMPL, MOVE, 

4. Subroutines Called by; EDIT 

5. External Data Sets Referenced; 

Lun File Name 

LOUT Terminal 

LFORW FOR007.DAT 


9023 


specified character 
it file to a new charac- 


Descr iption 


Number of occurrences of 
the character string to 
be changed 

Specification for the 
change 


REMVB, WRT 



Write 

Write 



ROUTINE: COMPL 


TYPE: Subroutine 

PURPOSE: Editor routine - locates a specified character 

string within another character string. 

USAGE : 

1. Calling Sequence: 

CALL COMPL (XLINE, CSTRNG, NCHR, NPST, NPED) 
FORTRAN Dimen- 


Name 

I/O 

Type 

Sion 

Description 

XLINE 

I 

Byte 

80 

Character string to 
searct 

CSTRNG 

I 

Byte 

80 

Character string to 
search for in XLINE 

NCHR 

I 

1*2 

1 

Number of characters in 
CSTRNG 

NPST 

I 

1*2 

1 

Position in XLINE at 
which to start search 

NPED 

0 

1*2 

1 

Position in XLINE at 
which next occurrence of 
CSTRNG starts. Set to 
81 if CSTRNG not found 


2. COMMON Blocks Used: None 

3. Subroutines Used: None 

4. Subroutines Called by: CHG, LOC 

5. External Dat?) Sets Referenced: None 
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ROUTINE; CRTDIS 


B 


TYPE; Subroutine 

PURPOSE; Report routine - writes a Discrepancy and Change 
History report to the terminal. 

USAGE; 

1. Calling Sequence: 

CALL CRTDIS (PROJ) 

FORTRAN Dimen- 

Name I/O Type sion Description 

PROJ I R*8 1 Project file name to be 

displayed in report 
heading 

2. COMMON Blocks Used; PILCM 

3. Subroutines Used: DATE, PIKONE 

4. Subroutines Called by: REPSEL 

5. External Data Sets Reference: 


Lun 

FILEl 

LUNOUT 


File Name 

User specified 
Terrainal 


Operation {s. 


Read 

Read, write 
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ROUTINE; CRTMIL 


TYPE; Subroutine 

PURPOSE; Report routine - writes 
History report to the terminal. 

USAGE; 

1. Calling Sequence; 

CALL CRTMIL (PROJ) 

FORTRAN Dimen- 

Name I/O Type sion 

PROJ I R*8 1 

2. COMMON Blocks Used; FILCM 

3. Subroutines Used; DATE 

4. Subroutines Called by; REPSEL 

5. External Data Sets Referenced; 

Lun File Name 

FILEl User specified 

LUNOUT Terminal 
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Milestone/Deliv, f ble 



Project file name to be 
displayed in report 
heading 


Operation (s] 


Read 

Read, write 



ROUTINE; CRTTST 


Test History report to 



Project file name to be 
displayed in report 
heading 


Operation (s ; 


Read 

Read, write 


ROUTINE: DECNUM 


TYPE: Subroutine 

PURPOSE: Editor routine - locates, and decodes if present, 

the repetition factor in an editor command. 

USAGE: 

1. Calling Sequence: 

CAIL DECNUM (ENTRY, IP'T, NLM, IFND, N) 


FORTRAN 

Name 

I/O 

Type 

Dimen- 

sion 

Description 

ENTRY 

I 

Byte 

80 

Editor command to search 
for repetition factor 

IPT 

I 

1*2 

1 

Pointer to locettion in 
ENTRY at which search 
starts 

NUM 

0 

1*2 

1 

Decoded number if factor 
present, not altered if 
factor not present 

IFND 

0 

1*2 

1 

> 0, no factor found 
= 1, factor found and de 
coded 

N 

I 

1*2 

1 

Length of ENTRY in bytes 

2 . COMMON 

Blocks Used 

: None 


3. Subroutines 

Used : 

None 


4. Subroutines 

Called 

by: GETLIN 



5. External Data Sets Referenced: None 


A-14 


9023 



ROUTINE; DEL 



9023 


a block of records from 



Number of blocks to de- 
lete from edit file 

Number of records in 
each block 


)eration (s) 


Write 
Write 
Wr ite 



ROUTINE; EDIT 


TYPE; Subroutine 

PURPOSE; Editor routine - controls selection of editor rou 
tines in response to editor command entered by user. 

USAGE : 

1. Calling Sequence: 


CALL EDIT (lOLD, ISKP, ITYPE) 


FORTRAN 

Name 

iZo 

Type 

Dimen- 

sion 

Description 

lOLD 

I 

1*2 

1 

Subfile existence on 
entry flag 
s 1, subfile exists 
=» 0, subfile empty (not 
used) 

ISKP 

0 

1*2 

1 

m 

Subfile disposition or. 
exit flag 

* 1, delete subfile 
» 0, save subfile 

ITYPE 

I 

1*2 

1 

Subfile content flag 
= 1, Discrepancy/Change 
data 

= 2, Milestone/ 

Deliverable data 
= 3, Test data 

2 . COMMON 

Blocks Used: 

CATCOM, 

FILCM, LUNCOM 


3. Subroutines Used; ADD, ADDP, EOT, CATINS, CHG, DEL, 

GETLIN, LOC, MOVE, NEX, NEXP, PRI , TOP 

4. Subroutines Called by; EDITOR 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LIN Terminal Write 

LFORW FOR007.DAT Write 
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ROUTINE: EDITOR 


TYPE: Subroutine 


PURPOSE: Editor routine - controls the creation and final 

disposition of the edit scratch files. 

USAGE: 

1. Calling Sequence: 


CALL EDITOR (ITYPE) 

FORTRAN Dimen- 

Name I/O Type sior. Description 

ITYPE I 1*2 1 Subfile content flag 

= 1, Discrepancy/Change 
data 

= 2 , Milestone/ 

Deliverable data 
» 3, Test data 


2. COMMON Blocks Used: FILCM, LUNCOM, MOVCOM 


3. 

Subroutines 

Used: CATFIL, EDIT, 

OPNX, REDCAT 

4. 

Subroutines 

Called by: EDTSEL 


5. 

External Data Sets Referenced: 



Lun 

File Name 

Operation (s) 


LFILE 

FOR002.DAT 

Open, close 


LOUT 

Terminal 

Write 


LFORW 

FOR007.DAT 

Write, close 


LBWK 

FOR008.DAT 

Close 
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ROUTINE: EDTSEL 


TYPE: Subroutine 

PURPOSE: Editor routine obtains the user's selection of 

subfile type to edit. If the selected subfile does not con- 
tain data^ the initial data entry routine is used, otherwise 
the full edit routines are used. 

USAGE : 

1. Calling Sequence: 

CALL EDTSEL (MFLAG, STAT) 

FORTRAN Dimen- 

Name I/O Type sion Description 

MFLAG I 1*2 1 Editor authorization flag 

= 0, user not authorized 
for edit (not used) 

> 1, user may edit 

STAT I L*1 1 Flag indicating presence 

of header record in proj- 
ect file: 

= 'O', old file, header 
present 

= ' N' , new file , no 
header record 

2. COMMON Blocks Used: FILCM 

3. Subroutines Used: CATPUT, EDITOR 

4. Subroutines Called by: CAT 

5. External Data Sets Referenced: 


File Name 


LUNA Terminal Read, write 

5 Terminal Write 
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ROUTINE: GETLIN 


TYPE; Subroutine 

PURPOSE; Editor routine - reads the editor command entered 
by the user. The type of command is determined. 

USAGE: 


1. Calling Sequence; 


CALL GETLIN (IFUN, NUM, STRNGl, lERROR) 


FORTRAN 

Name 

I/O 

0 

Type 

Dimen- 

sion 

Descr iption 

IFUN 

1*2 

1 

Code for entered command 
type 

NUM 

0 

1*2 

1 

Repetition factor, set t' 
1 if no factor is found 

STRNGl 

0 

Byte 

80 

Target and/or replacemen 
string for string manipu 
lation commands, termi- 
nated by a zero byte 

lERROR 

0 

1*2 

1 

(Not used, always set to 
zero) 

2 . COMMON 

Blocks 

Used: 

LUNCOM , 

MOVCOM 


3. Subroutines Used; DECNUM, REMVB 


4. 

5. 


Subroutines Called by: EDIT 

External Data Sets Referenced; 


Lun 


File Name 


LOUT 

LIN 


Terminal 

Terminal 


Operation (s) 

Write 

Read 
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ROUTINE; GETMOR 


TYPE; Subroutine 

PURPOSE; Editor routine - adds more records to the linked 
list of available records in the project file. 

USAGE ; 

1. Calling Sequence; 


CALL GETMOR (FILE, LAST, 

FORTRAN Dimen- 

Name I/O Type sion 

MORE} 

Description 

FILE I 

1*2 

1 

Logical unit number of 
the project file 

LAST I 

1*2 

1 

Record number of last 
record in list of avail- 
able records 

MORE I 

1*2 

1 

Number of new records to 
add to the end of the 
list of available records 

2. COMMON Blocks 

Used 

; None 


3. Subroutines Used; 

None 


4. Subroutines Called 

by; CAT I NS 

, CATPUT 

5. External Data 

Sets 

Referenced ; 


Lun 

File Name 

Operation ( s) 

FILE 

User 

specified 

Read, write 
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ROUTINE; LOG 


TYPE: Subroutine 

PURPOSE: Editor routine - locates the nth occurrence of a 

specified character string in the following records. If the 
nth occurrence of the string is found within a record, the 
record becomes the current line. If the nth occurrence of 
the string is not found, the current line remains the same 
as before the command was specified. 

USAGE : 

1. Calling Sequence: 



CALL LOC 

(NUM, 

STRNGl) 


FORTRAN 

Name 

I/O 

Type 

Dimen- 

sion 

Description 

NUM 

I 

1*2 

1 

Number of occurrence at 
which to stop search 

STRNGl 

I 

Byte 

80 

Character string to 
search for 

2. COMMON Blocks 

Used : 

LUNCOM 



3. Subroutines Used: COMPL, MOVE, WRT 

4. Subroutines Called by: EDIT 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LOUT Terminal Write 
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ROUTINE; MOVE 


TYPE; Subroutine 

PURPOSE: Editor routine <* moves the current line pointer in 

the edit file. Breakpoint records in the edit file are not 
counted when they are encountered (see MOVLIN) . 

USAGE : 

1. Calling Sequence: 

CALL MOVE (NX, XLINE, TERROR, lEOPX, ITOFX) 

FORTRAN Dimen- 


Name 

IZ2 

Type 

s ion 

Description 

NX 

I 

1*2 

1 

Number of records to move 
the current line pointer 

XLINE 

0 

R*8 

11 

Content of the record 
which becomes the cur- 
rent line 

TERROR 

- 

L*2 

1 

(Not used) 

lEOFX 

0 

1*2 

1 

End of file (EOF) flag 

* 0 , no EOF 

* 1, EOF encountered 

ITOFX 

0 

1*2 

1 

Top of file (TOF) flag 
= 0, no TOF 
» 1, TOF encountered 

2 . COMMON 

Blocks 

Used ; 

LUNCOM, 

MOVCOM 


3. Subroutines Used; MOVECR 

4. Subroutines Called by; ADD, ADDP, BOT, CHG, EDIT, LOC, 

NEX, NEXP, PRI, TOP 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 


LFILE 

FOR002.DAT 

Read 


LFORW 

FOR007.DAT 

Read , 

write 

LBKW 

FOR008.DAT 

Read , 

write 
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ROUTINE: MOVECR 


TYPE; Subroutine 

PURPOSE: Editor routine - copy a character array from one 

location to another for a specified length. 

USAGE : 

1. Calling Sequence: 

CALL MOVECR (FROM, TO, LEN) 

FORTRAN Dimen- 

Name I/O Type si on Description 

FROM I L*1 LEN Source location 

TO 0 L*1 LEN Destination location 

LEN I 1*2 1 Number of characters to 

copy 

2. COMMON Blocks Used; None 

3. Subroutines Used; None 

4. Subroutines Called by; MOVE, MOVLIN 

5. External Data Sets Referenced; None 
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ROUTINE; MOVLIN 


TYPE: Subroutine 

PURPOSE; Editor routine - move the current line pointer in 
the edit file. Breakpoint records in the edit file are 
counted when they are encountered (see MOVE) . 

USAGE : 

1. Calling Sequence: 

CALL MOVLIN (NX, XLINE, lERROR, lEOFX, ITOFX) 


FORTRAN 

Name 


Type 

Dimen- 

sion 

Description 

NX 

I 

1*2 

1 

Number of records to move 
the current line pointer 

XLINE 

0 

R*8 

11 

Contents of the record 
which becomes the cur- 
rent line 

I ERROR 

- 

L*2 

1 

(Not used) 

lEOFX 

0 

1*2 

1 

End of file (EOF) flag 
= 0 , no EOF 
= 1, EOF encountered 

ITOFX 

0 

1*2 

1 

Top of file (TOF) flag 
= 0, no TOF 
= TOF encountered 

2 . COMMON 

Blocks 

Used : 

LUNCOM , 

MOVCOM 


3. Subroutines Used; MOVECR 

4. Subroutines Called by: CATINS, DEL 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 


LFILE 

FOR002.DAT 

Read 


LFORW 

FOR007.DAT 

Read , 

write 

LBKW 

FOR008.DAT 

Read, 

write 
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ROUTINE; NEX 



1. Calling Sequence: 

CALL NEX (NUM) 

FORTRAN Dimen 

Name I/O Type . sion 

NUM I 1*2 1 


2. COMMON Blocks Used; LUNCOM 

3. Subroutines Used: MOVE 

4. Subroutines Called by: EDIT 

5. External Data Sets Referenced 

Lun File Name 

LOUT Terminal 
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the current line pointer 


ROUTINE: NEXP 


TYPE: Subroutine 

PURPOSE: Editor routine - changes the current line pointer 

in the edit file. Prints the new current line at the termi- 
nal . 

USAGE : 

1. Calling Sequence: 

CALL NEXP (NUM) 

FORTRAN Dimen- 

Name I/O Type sion Description 

NUM I 1*2 i Number of records to move 

the current line pointer 

2. COMMON Blocks Used; LUNCOM 

3. Subroutines Used; MOVE, WRT 

4. Subroutines Called, by: EDIT 

5. External Data Sets Referenced: 


File Name 


Operation (s) 


LOUT 


Terminal 


Write 
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ROUTINE: 01 NX 


initializes the edit scratch 


Dimen- 

sion Description 

1 Error flag 

= 0, No error 
= 1, error reading the 
sequential file 
» 2 , error opening one of 
the scratch files 

2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: None 

4. Subroutines Called by: EDITOR 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 


LFILE 

FOR002.DAT 

Read 


LOUT 

Terminal 

Write 


LFORW 

FOR007.DAT 

Open , 

write 

LBKW 

FOR008.DAT 

Open , 

write 


TYPE: Subroutine 

PURPOSE: Editor routine 

files. 

USAGE: 

1. Calling Sequence: 

CALL OPNX (lERR) 

FORTRAN 

Name I/O Type 

lERR 0 1*2 
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ROUTINE; PIKONE 


TYPE: Subroutine 

PURPOSE; Report routine - obtains the user's selection for 
the type of data to present in a Discrepancy and Change His- 
tory report wnen called the first time. Also used to deter- 
mine whether each Discrepancy and Change data record should 
be included in the report. 

USAGE ; 


1. Calling Sequence; 

CALL PICONE (FIRST, PRTFLG, VALID, CODE, DATA) 


FORTRAN 

Name 

1/2 

Type 

Dimen- 

sion 

Description 

FIPST 

I/O 

L*2 

1 

» .TRUE., display selec- 
tion menu 

3 .FALSE., no menu dis- 
play 

rr-TFLG 

0 

L*2 

1 

= .TRUE., record should 
be included in report 
= .FALSE., do not include 
record in report 

VALID 

0 

L*2 

1 

= .TRUE., user has se- 
lected the data type to 
include 

- .FALSE., user has se- 
lected not to display 
report 

CODE 

I 

L*1 

1 

Data type code for cur- 
rent record 
= 'D', discrepancy 
= 'C , change 

DATA 

I 

R*8 

16 

Current record from proj- 
ect file 

2 . COMMON 

Blocks 

Used: 

None 


3. Subroutines Used: 

None 



4. Subroutines Called by; CRTDIS, PRTDIS 
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5. External Data Sets Referenced: 

Lun File Name Ope 


LUNA 


Terminal 


Read, 
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ROUTINE 


PRI 


TYPE: Subroutine 

PURPOSE; Editor routine - move the current line pointer 
forwara in the edit file and print at the terminal each rec- 
ord encountered. 

USAGE : 

1. Calling Sequence: 



CALL PRI 

(NUM) 



FORTRAN 

Name 

HO 

Type 

Dimen- 

sion 

Description 

NUM 

I 

1*2 

1 

Number of records to 


print at the terminal 


2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: MOVE, WRT 

4. Subroutines Called by; EDIT 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LOUT Terminal Write 
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ROUTINE: PRTDIS 


TYPE: Subroutine 


PURPOSE: Report routine - writes a Discrepancy and Change 

History report to the print file. 

USAGE : 


1. Calling Sequence: 


CALL PRTDIS (PROJ, LUNOUT) 


FORTRAN 

Name 


Type 

Dimen- 

sion 

PROJ 

I 

R*8 

1 

LUNOUT 

I 

1*2 

1 

2 . COMMON 

Blocks Used: 

FILCM 


Description 

Project file name to be 
displayed in report head- 
ing 

Logical unit connected 
to print file 


3. Subroutines Used: DATE, PIKONE 


4. Subroutines Called by: REPSEL 

5. External Data Sets Referenced: 


Lun 


File Name 


Operation (s ) 


FILEl 

LUNA 

LUNOUT 


User specified Read 

Terminal Write 

CATLST.LST Write 
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ROUTINE: PRTMIL 


TYPE: Subroutine 

PURPOSE: Report routine - writes a Milestone/Deliverable 

History report to the print file. 

USAGE : 


1. Calling Sequence: 


CALL PRTMIL (PROJ, LUNOUT) 


FORTRAN 

Name 

I/O 

Type 

Dimen- 

sion 

PROJ 

I 

R*8 

1 

LUNOUT 

I 

1*2 

1 

2 . COMMON 

Blocks 

Used: 

FILCM 


3. Subroutines Used: DATE 


Description 

Project file name to be 
displayed in report head- 
ing 

Logical unit connected 
to print file 


4. Subroutines Called by: REPSEL 


5. External Data Sets Referenced: 


Lun 

FILEl 

LUNA 

LUNOUT 


File Name 

User specified 

Terminal 

CATLST.LST 


Operation (s) 

Read 

Write 

Write 
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ROUTINE: PRTTST 


TYPE: Subroutine 

PURPOSE: Report routine - writes a Test History report to 

the print file. 

USAGE: 


1. Calling Sequence: 


CALL PRTTST (PROJ, LUNOUT) 


FORTRAN 

Name 

I/O 

Type 

Dimen 

Sion 

PROJ 

7 

R*8 

1 

LUNOUT 

I 

1*2 

1 

2. COMMON 

Blocks 

Used: 

FILCM 


Description 

Project file .larae to be 
displayed in report head- 
ing 

Logical unit connected 
to print file 


3. Subroutines Used: DATE 


4. Subroutines Called by: REPSEL 

5. External Data Sets Referenced: 


.an 


File Name 


FILEl 

LUNA 

LUNOUT 


User specified 

Terminal 

CATLST.LST 


Operation (s) 

Read 

Write 

Write 
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ROUTINE; REDCAT 


TYPE: Subroutine 

PURPOSE: Editor routine - creates new version of a suLfile 

from the edit scratch files. Each block of records in the 
forwards file is used to create a single record in the sub- 
file by concatenating the data fields from the records in a 
record block. 

USAGE ; 

1. Calling Sequence: 


CALL REDCAT (FILE, FILEO, ITYPE) 


FORTRAN 

Name 

IZ2 

Type 

Dimen- 

sion 

Description 

FILE 

I 

1*2 

1 

Logical unit connected to 
the forwards edit file 

FI LEO 

I 

1*2 

1 

Associated variable for 
logical unit FILE 

ITYPE 

I 

1*2 

1 

Pointer to the specific 
subfile to receive the 
data from the forwards 
file 

2 . COMMON 

Blocks 

Used : 

CATCOM, 

FILCM 


3. Subroutines Used: None 

4. Subroutines Called by; EDITOR 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

FILEl User specified Read, write 

LUN5 Terminal Write 

FILE FOR007.DAT Read 
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ROUTINE: REMVB 


TYPE: Subroutine 

PURPOSE: Editor routine > skips blank characters in the 

editor command line entered by the user. 

USAGE : 

1. Calling Sequence: 


CALL REMVB (ENTRY, IPT, N) 

FORTRAN Dimen- 

’ame I/O Type sion 

Description 

ENTRY 

I 

Byte 

80 

Editor command line 

IPT 

I 

1*2 

1 

Location in command line 
at which to start search 
for non-blank character 

N 

I 

1*2 

1 

Length of command line 

2 . COMMON 

Blocks Used 

: None 


3. Subroutines 

Used: 

None 



4. Subroutines Called by: CHG, GETLIN 

5. External Data Sets Referenced: None 
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ROUTINE; REPORT 


TYPE: Subroutine 


PURPOSE; Report routine - obtains the user’s selection of 
output device (terminal or print file) . 

USAGE: 

1. Calling Sequence: 

CALL REPORT (LUNA, LUNOUT, PROJCT) 


FORTRAN 

Name 

I/O 

Type 

Dimen- 

sion 

Description 

LUNA 

I 

1*2 

1 

Logical unit connected to 
the user's terminal 

LUNOUT 

0 

1*2 

1 

Logical unit connected to 
user's selected output 
device for report display 

PROJCT 

I 

R*3 

1 

Project file name to be 
displayed in report 
heading * 

2 . COMMON 

Blocks 

Used: 

FILCM 



3. Subroutines Used: REPSEL 

4. Subroutines Called by; CAV 


5. External Data Sets Referenced:? 


Lun 


File Name Operation (s) 


LUNA Terminal 

LUNOUT CATLST.LST 


Read, write 
Open 
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ROUTINE: REPSEL 


TYPE: Subroutine 

PURPOSE: Report routine - obtains the user's selection of 

report type and passes control to thi appropriate routine 
based upon report type and output device. 

USAGE ; 


1. Calling Sequence: 

CALL REPSEL (LUNA, LUNOUT, PROJCT, ICRT) 


FORTRAN 

Name 

iZ2 

Type 

Dimen- 

sion 

Descr ipcion 

LUNA 

I 

1*2 

1 

Logical unit connected to 
the user's terminal 

LUNOUT 

I 

1*2 

1 

Logical unit connected to 
user's selected output 
device for report display 

PROJCT 

I 

R*8 

1 

Project file name to be 
displayed in report 
heading 

ICRT 

I 

1*2 

1 

Report device flag 


= 1, output device is the 
terminal 

= 2 , output device ’S the 
print file 

2. COMMON Blocks Used: FILCM 

3. Subroutines Used: CRTDIS, CRTMIL, CRTTST, PRTDIS, 

PRTMIL, PRTTST 

4. Subroutines Called by: REPORT 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LUNA Terminal Read, write 
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ROUTINE: TUP 


TYPE: Subroutine 

PURPOSE: Editor routine - move the current line pointer to 

the tirst data record in the edit file. 

USAGE: 

1. Calling Sequence: 

CALL TOP 

2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: MOVE 

4. Subroutines Called by: EDIT 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LOUT Terminal Write 
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ROUTINE! WRT 


TYPE: Subroutine 

PURPOSE: Editor routine - write a record from the edit 

scratch file to the terminal. Trailing blanks in the record 
are not written. 

USAGE : 

I. Calling Sequence: 



CALL WRT 

(OUTPUT, 

ISX, 

lEX) 

FORTRAN 

Name 

I/O 

Type 

Dimen 

sior. 

Description 

OUTPUT 

I 

Byte 

80 

Record to write to the 
terminal 

ISX 

I 

1*2 

1 

First printable character 
in OUTPUT 

lEX 

I 

1*2 

2 

Last printable character 


in OUTPUT (includes 
trailing blanks) 


2. COMMON Blocks Used: LUNCOM 

3. Subroutines Used: None 

4. Subroutines Called by: ADDP, CHG, LOG, NEXP, PRI 

5. External Data Sets Referenced: 

Lun File Name Operation (s) 

LOUT Terminal Write 
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APPENDIX B - CAT COMMON BLOCK INFOHMATION 


Some of the variables used to interface among the CAT execu- 
tive routine, the editor routines, and the report routines 
are stored in labeled COMMON blocks. The four CAT COMMON 
blocks and the subroutines which use them are listed below: 


COMMON 

Block 


Subroutine 

CATCOM 

CATFIL, CAT INS, 

CATPUT, EDIT, REDCAT 

FILCM 

CAT, CATFIL, CATINS, CATPUT, CRTDIS, CRTMIL, 
CRTTST, EDIT, EDITOR, EDTSEL, PRTDIS, PRTMIL, 
PRTTST, REDCAT, REPORT, REPSEL 

LUNCOM 

ADD, ADDP, BOT, 
EDITOR, GETLIN, 
OPNX, PRI, TOP, 

CATFIL, CATINS, CHG, DEL, EDIT, 
LOC, MOVE, MOVLIN, NEX, NEXP, 
WRT 

MOVCOM 

EDITOR, GETLIN, 

MOVii. MOVLIN 


Three of these COMMON blocks; CATCOM, FILCM, and LUNCOM are 
initialized in block data Routines as shown in Figures B-1 
through B-3. These three COMMON blocks are always incorpo- 
rated into CAT source code through the use of INCLUDE state- 
ments. The files included in this way are shown in 
Figures B-4 through B-6. The MOVCOM COMMON block is neither 
initialized in a block data routine nor incorporated using 
the INCLUDE statement. 

Detailed descriptions of the four COMMON blocks used by CAT 
are presented on the following pages. The descriptions are 
presented alphabetically by COMMON block name. The vari- 
ables for each block are listed in the order in which they 
are stored. 
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ORIGINAL PAGE It 
OF POOR QUALITY 


n-HOV-!32 


CflTBLK.FTN 


C 

C 


BLOCK DrtTi^ CATBLK 
ItlCLLine •CBTCOM. INC* 


DATA 

ate: :T 'DATE DEF'.'INSD fllM* 

.*/D0/'VY) * 

.*> 

ft 

1 

•DATE COP’.* PEC TED •* 

.*r»l DD VY* 

.*) > 

ft ^ 

*m 

•Date pel*. ‘EASED (M* 
• IirUEllEM'.'TOP > 
•CODE »C •,‘0P D» : * 

. T1/ DD .*Y) * 

* I* 

.* > 

ft 


* 

ft 

4 

* P 

» 

ft 

0 

5 

•DESC ^ *.' 

•CHANGES 

P • 

ft 

ft 

• 

6 

0 • 

ft 

♦ / 
# 

DATA 

BTEXT. - DATE DEF*.*INED (m* 

,*/DD/'Y^‘) * 

,*> 

• 

2 

•DATE SCH*. •EDULED t* 

. *rti 'DD ‘A" 

,*) > 

ft 

3 

. -DATE ACT*. • UAL UHV’ 

.‘DD-YV^ >* 

ft 

ft 

ft 

4 

• irPLEMEN* . ‘TOR > ■ ’ 

• • 

ft 

ft 

5 

•TYPE '> -.* 

• • 

ft 

ft 

6 

t 

•MILE ,> *.• 

4V * 

0 0 

ft 

ft 

ft 

DATA 

CTEMT •TEST DAT’ . -E •‘lirLDD* 

.*-'YY) :■ * 

ft 

ft 

ft 

ft 

•n 

•TEST CON*. •DOCTOR >* 

• ■ 

0 

ft 

ft 

ft 

ft 

3 

•DESC ^ *.* 

» » 

ft 

ft 

ft 

ft 

4 

5 

•RESULTS •.•^ 

12 t" 

0 • 

• 

ft 

ft 

ft 


DATO MrATu 3. !3. 3.8. 1.60.22. 

: 3. 3, 3. 3, 8. 72.0. 

5 8.8.72.32.0.0.0.' 

DATA CHhR 25.27.26.13.15.6.3. 
? 26.28.25.13.6.6.0. 

5 22. 16. 6.3. U. 0.0' 
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Figure B-1. Block Data Routine CATBLK 
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c 

DLHC^ DrtTi^ FILBLK 
C 

IMCLIinF ‘FILCM. tNC' 

C 

c HRaiirit HT nPE PESCPimnN 

c 

C FlLfJ I rPCHD'T FILE 

i: ►^V’hIL I PiHfirEP TO MENT rtViHLrtBLE LOCATION 

C FH'ri I FOPU«PP POINTER NOPE 

C LN'T' I LOST POINTER NOPE 

C FILF: t OENEPOL FILE PER POTO ’Tt?E 

C 

pH TO FILE I I .FILE.T .T 
t. 

Flip 


Ficrure B-2, Block Data Routine FILBLK 
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Il-MOV-02 LUNBLK.FTN 


BLOCK DrtTrt LUNBLK 
C 

INCLUDE ‘LIJMCOM. INC' 
C 

D»(TN LIN 5 
DhTh lout 6- 
DNTN I.FILE '' 2 '' 

DhTN LFOPM 7. 

DNTA 1.131 IJ O- 
C 

END 


Figure B-3. Block Data Routine LUNBLK 
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ORIGINAL PAQf 
OF POOR QUAUTY 


n-HOV-132 CATCOM. INC 


PAGE 


COMf ION. CATCOM/ ATEXT.BTEKT,CTEXT.NDATA.CHAR 
PEALte ATCXT(‘l,r) ,BrEXT(4,7) ,CTEXT(4.7) 
IMTEGEP (2 MDATA<r,3> .CHAR (7. 3) 


Figure B-4. INCLUDE Pile for COMMON Block CATCOM 


ORKMNAI. PAOt IS 
OF POOR QUALITY 


t i-iinv-'? '' 


FII.CM.INC 


PACE I 


njt !l II II ) F I U. M F I LE 1 . CWt I L , FI I • r • . LI ♦ • r * . F F lf:^ . MO . jn 
IIITri.FPi;.' FILFl.liVfllL.ni.l.H.FlLe2.fl0.jn 

Figure B-5. INCLUDE File for COMMON Block PILCM 


! 1 -tin. 

ni»inn:i L-;irnri 
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Figure B 


mioinal PMg n 
or POOR QUALOY 


LlUirnM. INC 


PilGE l 


LUI. '.ni.n. LFH.r. iriLR'l. 
ifiM'i. i.r iiri.in. im.i. ini i.in 
I. nt. I Mill . 1 1 It t . 1 nuMi, 

1 1 Mi I. 1 1 nni,!ii. t ni u. 1 Ui I.! 'I 


6. INCLUDE File for COMMON Block LUNCOM 
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ommKL PMH is 

OF POOS QUALITY 


COMMON BLOCKS CATCOM 

PURPOSES Contain Information daacriblng tha data fitld 
langths of aach typa of aubf Ua racord in tha projact fila* 
Tha daacriptor labala uaad in tha adit scratch filaa ara 
also atorad in this COMMON block. 


VARIABLES s 
Variable 

Typa 

DaacriPtion 

ATEXT(4,7) 

R*8 

Discrepancy and Change History adit 
fila descriptor labels 

BTEXT(4,7) 

R*8 

Milastona/Dalivarabla History adit 
fila descriptor labels 

CTEXT(4,7) 

R*8 

Text History adit fila descriptor la- 
bels 

NDATA(7,3) 

1*2 

Data field langths in a subfile racord 
or individual adit file racord 

CHAR(7,3) 

1*2 

Length of aach descriptor label 
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ORiQtNAL P/U2K If 
OF POOR QUALITY 


COMMON BLOCK! FILCM 

PURPOSBi Contain pointtra dtaerlbing tbt tubfilta in tht 
pcojaet filt. 

VARIABLES! 


variabla 

Tvoa 

DaacciDtion 

FILBl 

1*2 

Logical unit number eonnaetad to tha 
project file 

AVAIL 

1*2 

Pointer to next available record in 
the project file* a liat of available 
recorda 

PN<7) 

1*2 

Pointera to the firat record in each 
aubfile 

LN(7) 

1*2 

Pointera to the laat record in each 
aubfile 

FILE2 

1*2 

(Not uaed) 

NO 

1*2 

Aaaociated variable for FILBl (pointa 
to the next sequential record in the 
project file 

JO 

1*2 

(Not uaed) 
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COMMON BLOCK t LUNCOM 

PURPOSES Contain tht logical unit numbara and aasoeiatad 
variablas foe all filaa axcapt tha peojact fila* 

VARIABLES! 


vae labia 

Typa 

Daace lotion 

LIN 

1*2 

Logical unit numbae usad foe eaading 
Input feom tha taemlnal 

LOUT 

1*2 

Logical unit numbae usad foe welting 
output to tha taemlnal 

LFILE 

1*2 

Logical unit numbae connaetad to th^ 
peimaey adit flla 

LFILEO 

1*2 

Associatad vae labia foe LFILE (points 
to naxt saquantlal eacoed in LFILE) 

LFORW 

1*2 

Logical unit numbae connaetad to tha 
foewaed adit flla 

LFORWO 

1*2 

Associatad vae labia foe LFORW 

LBKW 

1*2 

Logical unit numbae connaetad to tha 
backwaed adit flla 

LBKWO 

1*2 

Associatad vae labia foe LBKW 
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COMMON BLOCKS MOVCON 

PURPOSE: Contain flag indicating which atquantial adit filt 

if tha aoucca foe cacoeda to ba writtan to tha forward fila 
whan tha currant racord pointar ia movad downward in tha 
fila. 

VARIABLES : 

Variabla Tvoa Paacriotion 

IFBACK 1*2 Racord aourca Indict tor 

- 1, aourca of racorda ia tha primary 
adit fila 

■ 2 , aourca of racorda ia tha backwarda 

adit fila 

■ 3, at and of fila 
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APPENDIX C - CAT PROJECT FILE RECORD DESCRIPTIONS 


Each record within a CAT project file belongs to one of five 
classes of record: header record, member of the Discrepaiscy 

and Change History subfile, member of the Milestone/ 
Deliverable History subfile, member of the Test History sub- 
file, or member of the project file list of available rec- 
ords. The project file is a direct access file containing 
fixed length (176 byte) unformatted records. 

The content of each class of record is given below. All 
fields described contain either binary integer (I) or alpha- 
numeric (A) data. 
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KtVOKD CLASS t Huadwr r«c?ocd 


CONTENT I 


LAnqth 

( Byt»«) Typ<t D^tcciptlo n 


.^-4 

7-8 

4-10 

U-12 

U-U 


lS-l7f» it! 


I Pointer to tlmt «v«llJibl* rec- 
ord in Lint ot avAilabl# c«corda 

1 Point#c to first rocord in th« 
Discr»p«ncy snd Chan^o History 
subfil*. If ssro« no data in 
this subfilo 

t Pointsr to lv'\st rscord in tho 
Diitcrspancy and Chami* History 
subfils 

I Pointsr to firwt rscord in ths 
Milsstons Dslivsrabls History 
subfils. If ssro, no data i't 
this subfils 

1 Pointsr to last rscord in ths 
Milsstons Dslivsrabls History 
subf ils 

I Pointsr to first rscord in ths 

Tsst History subfils. If «sro» 
no data in this subfils 

I Pointsr to last rscord in ths 

Tsst History subfils 

- (Not ussd) 


40 : 3 


RECORD CLASS: Member of the Mlleetone/Deliverable History 

subfile 


CONTENT : 
Byte 

Position 

Length 

(Bytes) 

Type 

Description 

1-2 

2 

I 

Pointer to next record in the 
subfile. If zeror this record 
is the last in the subfile 

3'4 

2 

I 

Pointer to previous record in 
the subfile. If zerOr this rec- 
ord is the first in the subfile 

5-6 

2 

I 

Record number of this record 

7-14 

8 

A 

Date defined (MM/DD/YY) 

15-22 

8 

A 

Date scheduled (MM/DD/YY) 

23-30 

8 

A 

Date actual (MM/DD/YY) 

31-38 

8 

A 

Implementor's name 

39-46 

8 

A 

Type of milestone or deliverable 

47-118 

72 

A 

Description of event or deliver- 
able 

119-176 

58 

- 

(Not used) 
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RECORD CLASS: Member of the Milestone/Delivecable History 

subfile 


CONTENT : 
Byte 

Position 

Length 

(Bytes) 

Type 

Description 

1-2 

2 

I 

Pointer to next record in the 
subfile. If zero, this record 
is last in the subfile 

3-4 

2 

I 

Pointer to previous record in 
the subfile. If zero, this rec- 
ord is first in the subfile 

5-6 

2 

I 

Record number of this record 

7-14 

8 

A 

Date defined (MM/DD/YY) 

15-22 

8 

A 

Date scheduled (MM/DD/YY) 

23-30 

8 

A 

Date actual (MM/DD/YY) 

31-38 

8 

A 

Implementor's name 

39-46 ■ 

8 

A 

Type of milestone or deliverable 

47-118 

72 

A 

Description of event or deliver- 
able 

119-176 

58 

- 

(Not used) 
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RECORD CLASS: Member of the Test History subfile 


CONTENT : 
Byte 

Position 

Length 

(Bytes) 

Type 

Description 

I- 2 

2 

I 

Pointer to next record in the 
subfile. If zeror this record 
is last in the subfile 

3-4 

2 

I 

Pointer to previous record in 
the subfile. If zero, this rec- 
ord is first in the subfile 

5-6 

2 

I 

Record number of this record 

7-14 

8 

A 

Test date (MM/DD/YY) 

15-22 

8 

A 

Test conductor's name 

23-94 

72 

A 

Description of test 

95-126 

32 

A 

Test results 

127-176 

50 

m 

(Not used) 
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RECORD CLASS: Member of the list of aveilable records 


CONTENT : 
Byte 

Position 

1-2 

3-176 


Length 

(Bytes) Type Description 

2 I Pointer to next record in list 

of available records. If this 
pointer is zero, it is the last 
record in the list 

174 - (Not used) 
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APPENDIX D - CAT ERROR MESSAGES 


CAT infocms the user of abnormal conditions during execution 
by writing messages to the user's terminal. The errors de- 
tected by CAT are, in general, those encountered while open- 
ing or reading an external file, syntax errors in the editor 
commands entered by the user, or a failure to locate the 
data requested by the user. 

Each message originating from CAT is presented below. The 
message is presented and followed by an explanation of the 
probable cause of the error. The messages are arranged ac- 
cording to the alphabetical order of the originating rou- 
tines. 


* 
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Message: 

I/O ERROR IN CURRENT PILE 


Explanation : An error occurred while reading the current 

line in the edit file. 

Originating Subroutines : ADD, ADDP, CHG, LOC 

Message : 

[ILL CMD] 

Explanation : The character string to append or to search 

for is missing or is not properly separated from the command. 

Originating Subroutines : ADD, ADDP, LOC 

Message : 

ERROR IN READING FILE 

Explanation : An I/O error occurred while reading the inter- 

vening recor Js while moving the current’ line pointer in the 
edit file. 

Originating Subroutines : EOT, CATINS, DEL, NEX, NEXP, PRI, 

TOP 


Message : 

*** nn IS AN INVALID SELECTION 

Explanation : The user's response to a request for a menu 

selection does not correspond to one of the available 
choices. 

Originating Subroutines : CAT, EDTSEL, PIKONE, REPORT, REPSEL 
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Message : 

ENCOUNTERED ERROR NUMBER nnnn 


Explanation : An error occurred while opening the CAT proj- 

ect file which Is not one of the more commonly encountered 
errors. 

Originating Subroutine : CAT 

Message : 

OPEN FAILURE 

Explanation : The CAT project file could not be opened. 

Originating Subroutine : CAT 

Message : 

FILE IN USE 

Explanation ; Another process currently has exclusive access 
to the CAT project file. 

Originating Subroutine ; CAT 
Message : 

FILE NAME SPECIFICATION ERROR 
"a. . .a" 

Explanation : The CAT project file name (a... a) contains a 

syntax error* 

Originating Subroutine : CAT 

Message : 

ERROR IN CHANGE COMMAND 

Explanation ; The specification for the target string or the 
replacement string contained an error. 

Originating Subroutine ; CHG 
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Messaqt t 

NO MATCH IN LINE 

Explanation : The targat string for a changa command could 

not ba found in tha currant lina. 

Originating Subroutine : CHG 

Masaaga : 

NO DATA AVAILABLE FOR DISCREPANCY REPORT 

Explanation : A Discrepancy and Change History report was 

requested and tha Discrepancy and Changa History subfile i 
empty . 

Originating Subroutines : CRTDIS, PRTDIS 

Message : 

NO DATA AVAILABLE FOR MILESTONE/DELIVERABLE REPORT 

Explanation : A Milestone/Deliverable History report was 

requested and the Milestone/Deliverable History subfile is 
empty . 

Originating Subroutines : CRTMIL, PRTMIL 

Message : 

NO DATA AVAILABLE FOR TEST HISTORY REPORT 

Explanation ; A Test History report was requested and the 
Test History subfile is empty. 

Originating Subroutines : CRTTST, PRTTST 
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Me»8aq» !t 

UNABLE TO EDIT FILE 

Explanation : Errors in opanlng aditor ac'atch fllas pravant 

tha aditor from accassing tha data. 

Originating Subroutlna : EDITOR 

Massaqa x 

INPUT LINE NOT RECOGNIZED— TRY AGAIN 

Explanation : The spaclfied aditor command was not racog- 

nlzad as a valid command. 

Originating Subroutlna : GETLIN 

Massage ; 

ERROR IN READING COMMAND LINE- -PLEASE REENTER 

Explanation : An I/O error occurred while reading the user's 

editor command. 

Originating Subroutine : GETLIN 

Message : 

OCCURRENCE OF STRING NOT FOUND 
THE CURRENT STRING IS: 

"a. . .a" 

Explanation ; The target string specified in a locate com- 
mand could not be found in one of the following records in 
the edit file. The printed string is the current line in 
the edit file. 

Originating Subroutine : LOC 
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ERROR IN READING FILE HEADER 

ExplanAtion t An I/O acror occucrad whila raadlng tha pcoj- 
act flla haadar racocd. 

Originating Subroutina i OPNX 

Maaaaqa t 

ERROR IN OPENING WORK FILES 

Explanation : An arroc occucrad whila opaning ona of tha 

aditoc scratch filas. 

Originating Subroutina : OPNX 
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APPENDIX E - SYSTEM GENERATION 


The CAT ■ystem can be generated from the source code by 
executing a few commands. The system generation procedure 
for the PDP-11/70 is described in Section E.l» and for the 
VAX-11/780 in Section E.2. 

E.l PDP-11/70 SYSTEM GENERATION 

To generate the CAT system for the PDP-11/70 r only one com- 
mand procedure needs to be executed. Figure E-1 is a list- 
ing of the GENCAT.CMD command procedure. This procedure 
compiles all CAT source code and builds the CAT task. The 
GENCAT.CMD procedure uses two other files to build the CAT 
task; the task builder command filer GENCAT.TKB and the CAT 
overlay description filer CAT.ODL (Figures E-2 and E-3r re- 
spectively) . The PDP-11/70 CAT system is generated by exec 
utlng the following command: 

0GENCAT 

E.2 VAX- 11/780 SYSTEM GENERATION 

To generate the CAT system for the VAX-11/780 r only one com 
mand procedure ne Is to be executed. Figure E-4 is a list- 
ing of the GENCAT.COM command procedure. This procedure 
compiles all CAT source coder builds an object code library 
and links the CAT task. The VAX-11/780 CAT system is gener 
ated by executing the following command: 

@GENCAT 
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F4P 

list 

HDD 

POP 

F4P 

LIST 

hDDP 

■ " *' ? 

F.;p 

LIST 

eoT 

errs- 

F.iP 

LIST 

CAT 

- * 

F4P 

LIS-^ 
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r * T 

F4P 

U 1 t : 

ChTFIL 


F4f- 

LI'T 

CAT IMS 
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^ -■ P 
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F4F 
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!• • 

F4P 

LIST 

COMPL 

cr,;.C’ 

ff jp 

LIST 

CPTMS 

" 

P4P 

LIST 

CPTMIL 

"0. • 

F4P 
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CPTTST 

POP 

F4P 

LIST 

DEC MUM 

P “ 

P4F 

LIST 

DEL 

SV' 

F4P 

LIST 

EDIT 

pf’lp 

F4F 

list 

EDITOR 

p-,C 

F«P 

LIST 

EDTSEL 

*vP 

F4P 

LIST 

FILBLI 

tftjP 

F4P 

list 

LIST 

GETLItl 

"CP 

PUP 

GET! lOP 

r ' 

p 4F 
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^ i.' r' 

F4P 
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p.r 

’ » C 
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F4P 
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MO ECP 
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LI-T 
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IF 
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"■■p 

F4F 
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PF'TMIL 
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F4P 

lIST 

PPTTOT 
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' ' -r 
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r ; c 

p.;p 

. ■'^1 

PE^'SEL 


'* ♦*” 
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Figure E-1. CAT PDP-11/70 System Generation Command 
Procedure (1 of 2) 
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:n i.IMB r-ATA COUECTION SOFTWAPE INGIMEEPIHG TOOL 
'.OM-AMt- ffILE 

'.P TO SEP 32 
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E’j'^»2CC 
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Figure E-1. CAT PDP-11/70 System Generation Command 
Procedure (2 of 2) 
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Figure E-2. CAT PDP-11/70 Ta*k Building Command 
Procedure 
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Figura E-3. CAT PDP-11/70 Ovtrlay Dascription 
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I pnR/N''X4 MRTMTL 
I PnR/NnX4 PRTIfX 

• P<5R/Mni4 •*nc»t 
I P''R/Nni4 mcmvm 

I pnR/Nni4 »r,»OMX 
f pnil/Nni4 tc»|f>L 

I rnM/NOX4 TQM • 

S F"R/N(5X4 MRT 

• t 

t » MOW MOILn THT f.XRRIRY 
S t 

I liT8»A»Y-'C'»C«t» rAT 


Figure E-4. CAT VAX-11/780 System Generation 
Command Procedure (1 of 2) 
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p«n(Er-«a C^'NfA'T.COM PkOt 2 


I I<TtMPy/:wsrRT «*AT »on,IIOOI>,inT,CAt*C*TPLP*eATFTL*i:>TXN$*CATm»CHG 
t IitiPAPY/IPfPPT CAT COPPt,CATOtf,CPt»»Xt.»epTT«t 
I titAPAPy/ZPSTAT DCeNMMrDVtifCDZT.RDtmtCDTSILimiLK 
t bTIPAPy/ZPS'RT CAT 0(TLrN.8RT«t0P*T.0e»riUNltiK*M0VRfMaVECR«M0VtiZW 
• LTBPAPY/ZPSRAT CAT Pf A,PeXP, 0 »MX,»ZKO»lf ,pPZ,MtOX»,PATHTL.PMT»T 
I tiZMAPy/ZPSfAT CAT nOCiTiRTMVA^AtpnRTffftPSCbfTOPfMIIT 
I t 

t liTNK/TX«:C*CAT C»T.CAT/LTMA»Y#X'*CbU01«(rATiLK,pniPbK,bUPWK) 


Figure E-4. CAT VAX-11/780 System Generation 
Command Procedure (2 of 2) 




E-7 


REFERENCES 


1. Digital Equlpmant Corporation# AA-5567B-TC# R8X-11 Util- 
litiaa Proctduraa Manual * Dactmbar 1977 

2. AA-1884C-TC* FORTRAN IV-PLUS Utar's Guida* Dacambar 

1979 

3. — , AA-D035B-TE, VAX»11 FORTRAN tJaar*a Guida , April 1980 


R-1 


9023 


BIBLIOGRAPHY Of SBI. LITBRATURg 


Th« technical paparSf rntmocandumi » and documants Iltttd in 
this bibliography ara organisad into two groups* Tha first 
group is eomposad of documants issuad by tha Softwara Bngi- 
naaring Laboratory (SSL) during its rasaaroh and davalopmant 
activitias. Tha sacond group inoludas matarials that wars 
publishad alsawhara but partaih to SBL activitias* 

SBL-Oricinatad Documants 

SBL-76-001, Procaadincs Prom tha First Summar Softwara 
Bneinaarinq Worieshop * August 1^76 

SBL-77-OOlf Tha Softwara Bnqinaying Laboratory * 

V. R. Basilir M* V. ^alkowits, t*. B* HcGarry, at al*» May 
1977 

SEL-77-002, Procaadinqs From tha Sacond Suminar Softwara 
Enqinaarinq Workshop . SaPtambar Idii 

SEL-77-003, Structurad FORTRAN Praorocassor (SPORT) » B. Chu 
and D* S. Wilson# Saptamoar 1977 

SEL-77-004# GSFC NAVPAK Dasion Soacif ications Languagas 
Study * P. A. Scha^ifar and C. B* Valaz# Octobar 1977 

SEL-78-001# FORTRAN Static Sourca Coda Analvstr (SAP) 

Dasiqn and Modula Dascr lotions * B. M. 0*Naillf 
S* R. Waligora# and C* dooravich# Fabruary 1978 

'’‘sEL-78-002, FORTRAN Static Sourca Coda Analvsar (SAP) 

Osar's Guida * E. M. O’Naill* i* R. Waligora# and 
d. i* dooravich# Fabruary 1978 

SBL-78-102# FORTRAN Static Sourca Coda Analyaar Program 
(SAP) TJsar's duida (Raviaion 1) * W. J. Dackar and 

W. A. Taylor# Saptambar 1982 

SEL-78-003# Evaluation of Draoar NAVPyt Softwara Dasign # 

K. Tasaki and F. E. HcGarry# Juna 1978 


T 

This document superseded by revised document* 


B-1 


9023 












SEL-78-004f Structured PORTy^N Pr*proc«i«or (SPORT) 
ppp-11/70 U«cr'« duidc , D. S. Wilion and B. Chu» September 


SEL-78-005, Proceeding! Prom the Third Summer Software Engi- 
neering Workihop . September 1978 

SEL-78^006, GSFC Software Eiyilneering Research Reguiremente 
Analysis Study , P. A. Scheffer and c7 E. Velez# November 1978 

SEL-78-007, Applicability of the Rayleigh Curve to the SEL 
Environment . T. E. Mapp, December 1978 

SEL-79-001^ SIMPL-D Data Base Reference Manual . 

M. V. Zelkowitz, July 1979 

SEL-79-002, The Software Engineering Laboratory; Rela- 
tionship Equations . K. Freburger and V. R. Baalli. May 1979 

SEL-79-003, Common Software Module Repository (CSMR) System 
Description ^d User^s Guide . C. E. Goorevich. A. L. Green. 
an<j S. R. WaiigorSf August 1979 


SEL-79-004, Evaluation of the Caine. Farber. and Gordon 
Program Desi^ Language (PPL) in the Goddard Space Flight 
Center (GSFC) Code 5^0 Software Design Environment . 

C. E. Goorevichr A. L. Green# and W. J. Decker r Septembe r 
1979 


SEL-79-005» Proceedings From the Fourth Summer Software 
Engineering Workshop . November 19*^9 ~ 

SEL-80-001, Functional Reauirements/Specif ications for 
Code 580 Configuration Analysis Tool (CAT) . F. K. Banks. 

A. L. Green f and C. E. Goorevlch, February 1980 

SEL-80-002, Multi-Level Expression Design Language- 
Requirement Level (MEDL-R) System Evaluation . W.J. Decker 
and C. E. Goorevich, May 1980 

SEL-80-003r Multimission Modular Spacecraft Ground Support 
Software System (^s/gssS) State-of-the-Art Computer 
Systems/Compatibility Study. T. Welden. M. McClellan, and 
p: Liebe^tzT’MayTlSo 

SEL-80-004. System Description and User’s Guide for Code 580 
Configuration Analysis Tool (CAT) . F. K. Banks. 

W. J. Decker# J. G. Garrahan# et al.# October 1980 

SEL-80-005# A Study of the Musa Reliability Model . 

A. M. Miller# November 1980 


B-2 



4 i 


T1 

i i 


9023 










SEL-80-006r Proc»edinqs From th« Fifth Annual Softwag# 
EnqlneTinq Workahop * MovmbT 

SEL-80-007r An Appralaal of Sqlqctqd Coat/Rqyurc# Ljtlraatlon 
Modqls gor Soittwarq ivatgraq / Cook and P. E. (^dacryr 

December 

+ 

SEL-81-001, Guide to Data Collection # V. B. Church# 

D. N. Card# F. B. McGarry# et al.# September 1981 

SEL-81-101# Guide to Data Collection # V. B. Church# 

D. N. Card# F. E. McGarry# et al«# August 1982 

SEL-81-002# Software Enqlneerinq Laboratory (SEP Data Base 
Orqanization anj User's Guide * D. C. Wvckof^» G. Pace* and 
F. E. McGarry# September 

SEL-81-003# Software Enqlneerinq Laboratory (SEP Data Base 
Maintenance System (DBAM) User's Guide and System De- 
scription . D. N. Card* D» C. Wvckoiif» and G. Paqe# Septembe r 

4 » 

SEL-81-004# The Software Enqlneerinq Laboratory « 

D. N. Card# F. E. McGarry# G. Page# et al.# September 1981 

SEL-81-104# The Software Enqlneerinq Laboratory # D. N. Card# 
F. E. McGarry# G. Page# et al.# February 1982 

SEL-81-005# Standard Approach to Software Development # 

V. E. Church# F. B. McGarry# G. Page# et al.# September 1981 

SEL-81-105# Recommended Approach to Software Development , 

S. Eslinger# F. E. McGarry# and G. Page# May 1982 

SEL-81**006# Software Engineering Laboratory (SEP pocumen^ 
Library (DOCLIB) System Description and User* a Gulda l 

W. Taylor anck W. J. Decker# December 1981 

SEL-81-007# Software Enqlneerinq Laboratory (SEL) Com- 
pendium of Tools # W. J. Decker# E. J. Smith# A. L. Green# 
et al.# February 1981 

SEL-81-107# Software Engineering Laboratory (SEL) Compendium 
of Tools # W. J. Decker# W. A. Taylor# and E. J. Smith# 
February 1982 


This document superseded by revised document. 


B-3 


9023 










SEL-81-008, Cost yd Rallab^ity Eatlreatlon Mod«lt (CAREM) 
UsT*« Guido . i. dook and tf. Edwrd»» fobrusry 19^1 

SEL-81-00*-^r Softwares Enginoorlng Laboratory Proqrsmrotr 
Workbanch Phaaa 1 Evaluation . W. J. Dackar and 
E. Mcdarry# March i9^i 

SEL-81-010^ Parformanca and Evaluation of an Indapandant 
Softwara Vitrification and Intagration Procaia # G. Paoa and 
f, Mclaaxryr May 1^81 

SEL-81-011/ Evaluating Softwara Davalooroant bv Analvaia of 
Chanqa Data , D. M« Waisaf Novambar I98l 

SEL-8l-012r Tha Raylalah Curva As a Modal for Effort 
Distribution ovar tha tita of kadium ^cala Softwara Syotams» 
G. 0. picaseso, Dacambar 1981 

SEL-81-013r Procaadlnqs From tha Sixth Annual Softwara Enql- 
naarlnq WorkHKop . Dacambar 19^1 

SEL-81-014/ Automatad Collactlon of Softwara Eyinaarlng 

Data In tha ^oTtwara Enginaarlng Laboratory (SElH 

A. L. Graan, W. J. Dackar^ and F. E. McGarry^ Saptambar 1981 

SEL-82-001» Evaluation of Managamant Maasuras of software 
Davalopmant .~G. Paga» D. N. Card, and F. E. McGarry, 
September 1982, vols. 1 and 2 

SEL-82-002, FORTRAN Static Source Code Analyzer Program 
(SAP) Systera~Descr lotion , W» A. Tavlor and w. J. Dackar, 
August 

SEL-82-003, Sof tware Enginaarlng Laboratory fSEL) Data Base 
Reporting Soltw^Sre User^s Guide and System Descr lot loiT 
P. Lo, Septembsi:^ 1982 

SEL-82-004, ColJtcted Software Engineering Papers t 
Volume 1 > July l|82 

SEL-82-005, Gl 08 |ary of Software Engineering Laboratory 
Terms * M. G. Rohi^ader, December 1982 

SEL-82-006, Annotlnted Bibliography of Software Engineering 
Laboratory (SEP literature . D.N. Card. November 1982 


B-4 


9023 









SEL-R«lat«d Llf ratuf 


Bailay, J. W., and V. R. Baalli, ”A Mata-Modal for Soft- 
waca Davalopmant Rasourca Expandituraa^ " Procaadlnoi of 
tha Fifth Intacnational Confaranca on Sof'twara Enqinaarinq . 
Naw York* Computar Sociatlas Pcaaa» 1981 

Banka, F. K., "Configuration Analysis Tool (CAT) Dasign," 
Computer Sciancas Corporation, Technical Memorandum, March 
1980 

t h 

Basili, V. R. , "Models and Metrics for Software Management 
and Engineering," ASME Advances in Computer Technology # 
January 1980, vol. i 

Basili, V. R., "SEL Relationships for Programming Measure- 
ment and Estimation," University of Maryland, Technical 
Memorandum, October 1979 

Basili, V. R,, Tutorial on Models and Metrics for Software 
Management and Engineering . New York: Computer Societies 

Press, 1980 (also designated SEL-80-008) 

i* i* 

Basili, V. R. , and J, Beane, "Can the Parr Curve Help With 
Manpower Distribution and Resource Estimation Problems?", 
Journal of Systems and Software * February 1981, vol. 2, 
no. 1 ” 

1 * 1 " 

Basili, V. R. , and K. Freburger, "Programming Measurement 
and Estimation in the Software Engineering Laboratory," 
Journal of Systems and Software , February 1981, vol. 2, 
no. 1 

Basili, V. R. , and B. T. Perricone, Software Errors and 
Complexity: An Empirical Investigation * University of 

Maryland, Technical Report TR-li95, August 1982 

f *f* 

'Basili, V. R. , and T. Phillips, "Evaluating and Comparing 
Software Metrics in the Software Engineering Laboratory," 
Proceedings of the ACM SIGMETRICS Svmposium/Workshop; 

Quality Metrics . March 1961 


This article also appears in SBL-82-004, Collected Software 
Engineering Papers: Volume 1 . July 1982. 


B-5 


9023 



Basllir V. R.r R. W. Salby# and T. Phillipa» Matric Analvaia 
and Data Validation /toroaa FORTRAN Projacta * tinlvacalty of 
Marylano, Tachnical Raport, Novambar l^i&2 

3asili» V. R.f and R. Raitac» "Evaluating Autonatabla Haas- 
ucaa for Softwara Davalopmant , " Procaadlnoa of tha Workshop 
on Quantitativa Softwara Modala for RallaDiiitv* Coraplaxitv 
andl ^oit . 6ctobar 

Basilif V* R.r and M. V. Zalkowltz^ "Dasigning a Softwara 
Maasuramant Exparimant," P rocaadlnoa of tha Softwara Llfa 
Cycla Manaoamant WorkahopT SaPtawbar 1977 

^^Baaillr V. R.> and M. v. Zalkowitz# "Oparation of tha Soft- 
wara Enginaaring Laboratory#" Procaadlnoa of tha Sacond 
Softwara Llfa Cvcla Manaoamant Workahop # Auouat 1976 

Baaill# V. R,, and N. v. Zalkowltz# "Naaauring Softwara 
Oavalopmant Charactarlatlcs In tha Local Environmant# " 
Coraputara and Structuraa . Auguat 1978# vol. 10 

Baaili# V. R. # and N. V. Zalkowitz# "Analyzing Nadlum Scala 
Softwara Oavalopmant # " Procaadlnoa of tha Third Intar na- 
tional Confaranca on Softwara jfenoinaarlno . Naw York? 

Computer Sociatiaa Praaa# 1978 

^^Basili# V. R»# and M. V. Zalkowitz# "Tha Softwara 
Engineering Laboratory: Objectivea#" Procaadlnoa of tha 

Fiftaenth Annual Confaranca on Comoutar Paraonnal Raaaarch. 
Augua t ' mi 

Card# D. N.# "Early Eatimation of Raaourca Expandituraa and 
Program Size#" Computer Sciences Corporation# Technical 
Memorandum# June 1982 

Card# D. N.# "Comparison of Regression Modeling Tachniquaa 
for Resource Eatimation#" Computer Sclancaa Corporation# 
Technical Memorandum# 'November 1982 

Card# D. N. # and M. G. Rohledar# "Report of Data Expansion 
Efforts#" Computer Sciences Corporation# Technical Memo- 
randum# September 1982 

+ -f* 

Chen# E.# and M. V. Zelkowitz# "Use of Cluster Analysis To 
Evaluate Software Engineering Methodologies#" Proceedings 
of the Fifth International Conference on Softwara Engineer- 
ing * Mew Vork: Computer Societies >ress# l$di 


TT 

This article also appears in SEL-82-004# Collected Software 
Engineering Papers: Volume 1 # July 1982. 

B-6 


9023 




Fr«burg«rr K., "A Model of the Software Life Cycle” (paper 
prepared for the University of Maryland r December 1978) 

Higher Order Software^ Inc., TR-9, A Demonstration of AXES 
for NAVPAK . M. Hamilton and S. Zeldin, September (also 

designate? SEL-77-005) 

Hislop, G., "Some Tests of Halstead Measures” (paper pre- 
pared for the University of Maryland, December 1978) 

Lange, S. F., ”A Child's Garden of Complexity Measures” 
(paper prepared for the University of Maryland, December 
1978) 

Miller, A. M., ”A Survey of Several Reliability Models” 
(paper prepared for the University of Maryland, December 
1978) 

National Aeronautics and Space Administration (NASA) , NASA 
Software Research Technology Worksho p (proceedings) , March 

Page, G. , "Software Engineering Course Evaluation," Computer 
Sciences Corporation, Technical Memorandum, December 1977 

Parr, F. , and D. Weiss, "Concepts Used in the Change Report 
Form,” NASA, Goddard Space Flight Center, Technical Memoran- 
dum, May 1978 

Reiter, R. W., "The Nature, Organization, Measurement, and 
Management of Software Complexity” (paper prepared for the 
University of Maryland, December 1976) 

Scheffer, P. A., and C. E. Velez, "GSFC NAVPAK Design Higher 
Order Languages Study: Addendum," Martin Marietta Corpora- 

tion, Technical Memorandum, September 1977 

Turner, C., and G. Caron, A Comparison of RADC and NASA/SEL 
Software Development* Data , Data and Analysis Center for 
Soi^tware, Special Publication, May 1981 

Turner, C. , G. Caron, and G. Brement, NASA/SEL Data Compen- 
dium # Data and Analysis Center for Software, Special Publi- 
cation, April 1981 

Weiss, D. M. , "Error and Change Analysis," Naval Research 
Laboratory, Technical Memorandum, December 1977 

Williamson, I. M, , "Resource Model Testing and information," 
Naval Research Laboratory, Technical Memorandum, July 1979 


B-7 


9023 


J» .j, 

ZelKowitz, M. v.f **Rttsourc« Eatimation for Madium Seal# 
Softwart Projacta," Procaadinoa of tha Twalfth Confaranca on 
tha Intacfaca of Statiatlca and! Comoutar Scianca . Naw York: 
Computar ^ociatiaa Praaar 

ZalkowitZf N. V. I "Data Collaction and Evaluation foe Ex- 
parlmantal Computar Scianca Raaaarchr" Empirical Foundationa 
for Computar and Information Scianca (procaadiinga ^ , Novambar 
1902 

zalkowitzv M. V., and v. R. Baaili# "Oparational Aapacta of 
a Software Maaauramant Facility," Procaedinoa of tha Soft- 
wara Lif» Cvcla Manaoamant Workahop , Saptambar 1977 


tt 

This article also appears in SEL-82<-004, Collected Software 
Engineering Papers: Volume 1 / July 1982. 


B-8 





